# Contact mappings and synchronization

Source: https://neondeerdata.com/docs/api/brevo/contacts/

Inspect attributes, configure mappings and directions, and update existing linked contacts.

The APIs on this page require alpha access for your organization. App availability and API access are separate. [Check access and permissions](https://neondeerdata.com/docs/api/permissions/).

## Get Brevo contact update settings

```http
GET /v1/brevo-integration/sync-settings

```

Gets whether Brevo contacts are kept up to date from Attio automatically, whether Attio changes are being received, the include and exclude filters, and the latest update of all contacts. include and exclude are condition groups on People, the same shape a filtered duplicate scan takes: a Person is sent when it matches include (or there is none) and does not match exclude. A Person that stops matching is not updated again; nothing is removed from Brevo.

Requires `brevo:config:read`. The connection also needs access to the relevant tables, objects, or workflows.

MCP action: `get_brevo_sync_settings`. Its arguments use the names below, except fields marked REST only. An HTTP header is passed using its argument name in MCP.

No request parameters are needed.

### Response

| HTTP status | Result                                                                |
| ----------- | --------------------------------------------------------------------- |
| `200`       | The requested result. Asynchronous work returns an operation to poll. |

Required fields are required within their containing object. Notes identify fields that apply only to a particular response alternative.

| Response field                                | Type                                                                                                                                                        | Required in object | Notes                                                                                                                                         |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `data`                                        | object                                                                                                                                                      | Yes                |                                                                                                                                               |
| `data.object`                                 | `"brevo_sync_settings"`                                                                                                                                     | Yes                |                                                                                                                                               |
| `data.enabled`                                | boolean                                                                                                                                                     | Yes                |                                                                                                                                               |
| `data.watch`                                  | `"off"`, `"starting"`, `"on"`, `"unavailable"`, `"reconnect_required"`                                                                                      | Yes                |                                                                                                                                               |
| `data.filters`                                | object                                                                                                                                                      | Yes                |                                                                                                                                               |
| `data.filters.include`                        | \_\_schema0 or null                                                                                                                                         | Yes                |                                                                                                                                               |
| `data.filters.include.type`                   | `"and"`, `"or"`                                                                                                                                             | Yes                | Alternative 1.                                                                                                                                |
| `data.filters.include.conditions`             | array of object or \_\_schema0                                                                                                                              | Yes                | Alternative 1.                                                                                                                                |
| `data.filters.include.conditions[].type`      | `"attribute"`                                                                                                                                               | Yes                | Alternative 1\. When data.filters.include.conditions\[\].type is `"attribute"`.                                                               |
| `data.filters.include.conditions[].attribute` | string                                                                                                                                                      | Yes                | Alternative 1\. When data.filters.include.conditions\[\].type is `"attribute"`. When data.filters.include.conditions\[\].type is `"related"`. |
| `data.filters.include.conditions[].operator`  | `"is"`, `"is_not"`, `"contains"`, `"not_contains"`, `"lt"`, `"lte"`, `"gt"`, `"gte"`, `"any_of"`, `"none_of"`, `"empty"`, `"not_empty"`                     | Yes                | Alternative 1\. When data.filters.include.conditions\[\].type is `"attribute"`.                                                               |
| `data.filters.include.conditions[].value`     | string or number or boolean or array of string                                                                                                              | No                 | Alternative 1\. When data.filters.include.conditions\[\].type is `"attribute"`.                                                               |
| `data.filters.include.conditions[].type`      | `"related"`                                                                                                                                                 | Yes                | Alternative 1\. When data.filters.include.conditions\[\].type is `"related"`.                                                                 |
| `data.filters.include.conditions[].object`    | string                                                                                                                                                      | Yes                | Alternative 1\. When data.filters.include.conditions\[\].type is `"related"`.                                                                 |
| `data.filters.include.conditions[].where`     | \_\_schema0                                                                                                                                                 | Yes                | Alternative 1\. When data.filters.include.conditions\[\].type is `"related"`.                                                                 |
| `data.filters.exclude`                        | \_\_schema0 or null                                                                                                                                         | Yes                |                                                                                                                                               |
| `data.filters.exclude.type`                   | `"and"`, `"or"`                                                                                                                                             | Yes                | Alternative 1.                                                                                                                                |
| `data.filters.exclude.conditions`             | array of object or \_\_schema0                                                                                                                              | Yes                | Alternative 1.                                                                                                                                |
| `data.filters.exclude.conditions[].type`      | `"attribute"`                                                                                                                                               | Yes                | Alternative 1\. When data.filters.exclude.conditions\[\].type is `"attribute"`.                                                               |
| `data.filters.exclude.conditions[].attribute` | string                                                                                                                                                      | Yes                | Alternative 1\. When data.filters.exclude.conditions\[\].type is `"attribute"`. When data.filters.exclude.conditions\[\].type is `"related"`. |
| `data.filters.exclude.conditions[].operator`  | `"is"`, `"is_not"`, `"contains"`, `"not_contains"`, `"lt"`, `"lte"`, `"gt"`, `"gte"`, `"any_of"`, `"none_of"`, `"empty"`, `"not_empty"`                     | Yes                | Alternative 1\. When data.filters.exclude.conditions\[\].type is `"attribute"`.                                                               |
| `data.filters.exclude.conditions[].value`     | string or number or boolean or array of string                                                                                                              | No                 | Alternative 1\. When data.filters.exclude.conditions\[\].type is `"attribute"`.                                                               |
| `data.filters.exclude.conditions[].type`      | `"related"`                                                                                                                                                 | Yes                | Alternative 1\. When data.filters.exclude.conditions\[\].type is `"related"`.                                                                 |
| `data.filters.exclude.conditions[].object`    | string                                                                                                                                                      | Yes                | Alternative 1\. When data.filters.exclude.conditions\[\].type is `"related"`.                                                                 |
| `data.filters.exclude.conditions[].where`     | \_\_schema0                                                                                                                                                 | Yes                | Alternative 1\. When data.filters.exclude.conditions\[\].type is `"related"`.                                                                 |
| `data.latest_run`                             | object or null                                                                                                                                              | Yes                |                                                                                                                                               |
| `data.latest_run.object`                      | `"brevo_sync_run"`                                                                                                                                          | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.id`                          | string                                                                                                                                                      | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.state`                       | `"running"`, `"finished"`, `"stopped"`                                                                                                                      | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.sent`                        | integer                                                                                                                                                     | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.skipped`                     | integer                                                                                                                                                     | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.failed`                      | integer                                                                                                                                                     | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.started_at`                  | string                                                                                                                                                      | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.finished_at`                 | string or null                                                                                                                                              | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.stop`                        | object or null                                                                                                                                              | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.stop.setting`                | `"mappings"`, `"filters"`                                                                                                                                   | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.stop.problem`                | `"attio_missing"`, `"provider_missing"`, `"type_changed"`, `"duplicate"`, `"email_attribute"`, `"contact_id_attribute"`, `"changed"`, `"filter"`, `"other"` | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.stop.attio_attribute_id`     | string or null                                                                                                                                              | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.stop.brevo_attribute`        | string or null                                                                                                                                              | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.stop.filter`                 | object or null                                                                                                                                              | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.stop.filter.group`           | `"include"`, `"exclude"`                                                                                                                                    | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1\. Alternative 1.                                                             |
| `data.latest_run.stop.filter.attribute`       | string                                                                                                                                                      | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1\. Alternative 1.                                                             |
| `data.latest_run.stop.filter.object`          | string                                                                                                                                                      | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1\. Alternative 1.                                                             |
| `data.latest_run.undo`                        | object or null                                                                                                                                              | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.undo.state`                  | `"available"`, `"running"`, `"finished"`                                                                                                                    | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.undo.contacts`               | integer                                                                                                                                                     | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.undo.restored`               | integer                                                                                                                                                     | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.undo.changed`                | integer                                                                                                                                                     | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.undo.failed`                 | integer                                                                                                                                                     | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.when_brevo_has_value`                   | `"always"`, `"keep_when_empty"`, `"fill_empty"`                                                                                                             | Yes                |                                                                                                                                               |
| `data.version`                                | string                                                                                                                                                      | Yes                |                                                                                                                                               |

### Errors

| HTTP status | Meaning                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | One of: credential_in_url, invalid_parameter, unknown_parameter.                                                                                  |
| `401`       | One of: missing_credential, invalid_credential, credential_expired, credential_revoked.                                                           |
| `402`       | One of: payment_overdue.                                                                                                                          |
| `403`       | The current permissions, plan or policy do not allow this request.                                                                                |
| `404`       | One of: not_found.                                                                                                                                |
| `409`       | The request conflicts with current resource state, authorization or an earlier request. Read the error code and current resource before retrying. |
| `410`       | The requested resource or retained recovery data has expired.                                                                                     |
| `412`       | One of: version_conflict.                                                                                                                         |
| `413`       | One of: request_too_large.                                                                                                                        |
| `422`       | A field, filter or selection cannot be used for this request.                                                                                     |
| `423`       | One of: organization_reopening.                                                                                                                   |
| `428`       | One of: customer_agreement_required.                                                                                                              |
| `429`       | One of: rate_limited.                                                                                                                             |
| `503`       | One of: service_unavailable.                                                                                                                      |

See [errors and recovery](https://neondeerdata.com/docs/api/errors/) and [safe retries](https://neondeerdata.com/docs/api/requests/) before repeating a write.

## Change Brevo contact update settings

```http
PUT /v1/brevo-integration/sync-settings

```

Turns keeping Brevo contacts up to date on or off and replaces the filters, at the version the settings answered (expected_version). Filters name People attributes, or attributes of an object a People attribute points to (list_brevo_sync_attributes). include and exclude are condition groups on People, the same shape a filtered duplicate scan takes: a Person is sent when it matches include (or there is none) and does not match exclude. A Person that stops matching is not updated again; nothing is removed from Brevo. Send null for no filter.

Requires `brevo:config:write`. The connection also needs access to the relevant tables, objects, or workflows.

MCP action: `update_brevo_sync_settings`. Its arguments use the names below, except fields marked REST only. An HTTP header is passed using its argument name in MCP.

### Parameters

| Name                                     | Send in               | Required           | Type or allowed values                                                                                                                  | Notes                                                                                                                               |
| ---------------------------------------- | --------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `enabled`                                | JSON body             | Yes                | boolean                                                                                                                                 |                                                                                                                                     |
| `filters`                                | JSON body             | Yes                | object                                                                                                                                  |                                                                                                                                     |
| `filters.include`                        | Within the JSON value | Within this object | DedupeScanConditionGroup or null                                                                                                        |                                                                                                                                     |
| `filters.include.type`                   | Within the JSON value | Within this object | `"and"`, `"or"`                                                                                                                         | Alternative 1.                                                                                                                      |
| `filters.include.conditions`             | Within the JSON value | Within this object | array of object or DedupeScanConditionGroup                                                                                             | Alternative 1.                                                                                                                      |
| `filters.include.conditions[].type`      | Within the JSON value | Within this object | `"attribute"`                                                                                                                           | Alternative 1\. When filters.include.conditions\[\].type is `"attribute"`.                                                          |
| `filters.include.conditions[].attribute` | Within the JSON value | Within this object | string                                                                                                                                  | Alternative 1\. When filters.include.conditions\[\].type is `"attribute"`. When filters.include.conditions\[\].type is `"related"`. |
| `filters.include.conditions[].operator`  | Within the JSON value | Within this object | `"is"`, `"is_not"`, `"contains"`, `"not_contains"`, `"lt"`, `"lte"`, `"gt"`, `"gte"`, `"any_of"`, `"none_of"`, `"empty"`, `"not_empty"` | Alternative 1\. When filters.include.conditions\[\].type is `"attribute"`.                                                          |
| `filters.include.conditions[].value`     | Within the JSON value | No                 | string or number or boolean or array of string                                                                                          | Alternative 1\. When filters.include.conditions\[\].type is `"attribute"`.                                                          |
| `filters.include.conditions[].type`      | Within the JSON value | Within this object | `"related"`                                                                                                                             | Alternative 1\. When filters.include.conditions\[\].type is `"related"`.                                                            |
| `filters.include.conditions[].object`    | Within the JSON value | Within this object | string                                                                                                                                  | Alternative 1\. When filters.include.conditions\[\].type is `"related"`.                                                            |
| `filters.include.conditions[].where`     | Within the JSON value | Within this object | DedupeScanConditionGroup                                                                                                                | Alternative 1\. When filters.include.conditions\[\].type is `"related"`.                                                            |
| `filters.exclude`                        | Within the JSON value | Within this object | DedupeScanConditionGroup or null                                                                                                        |                                                                                                                                     |
| `filters.exclude.type`                   | Within the JSON value | Within this object | `"and"`, `"or"`                                                                                                                         | Alternative 1.                                                                                                                      |
| `filters.exclude.conditions`             | Within the JSON value | Within this object | array of object or DedupeScanConditionGroup                                                                                             | Alternative 1.                                                                                                                      |
| `filters.exclude.conditions[].type`      | Within the JSON value | Within this object | `"attribute"`                                                                                                                           | Alternative 1\. When filters.exclude.conditions\[\].type is `"attribute"`.                                                          |
| `filters.exclude.conditions[].attribute` | Within the JSON value | Within this object | string                                                                                                                                  | Alternative 1\. When filters.exclude.conditions\[\].type is `"attribute"`. When filters.exclude.conditions\[\].type is `"related"`. |
| `filters.exclude.conditions[].operator`  | Within the JSON value | Within this object | `"is"`, `"is_not"`, `"contains"`, `"not_contains"`, `"lt"`, `"lte"`, `"gt"`, `"gte"`, `"any_of"`, `"none_of"`, `"empty"`, `"not_empty"` | Alternative 1\. When filters.exclude.conditions\[\].type is `"attribute"`.                                                          |
| `filters.exclude.conditions[].value`     | Within the JSON value | No                 | string or number or boolean or array of string                                                                                          | Alternative 1\. When filters.exclude.conditions\[\].type is `"attribute"`.                                                          |
| `filters.exclude.conditions[].type`      | Within the JSON value | Within this object | `"related"`                                                                                                                             | Alternative 1\. When filters.exclude.conditions\[\].type is `"related"`.                                                            |
| `filters.exclude.conditions[].object`    | Within the JSON value | Within this object | string                                                                                                                                  | Alternative 1\. When filters.exclude.conditions\[\].type is `"related"`.                                                            |
| `filters.exclude.conditions[].where`     | Within the JSON value | Within this object | DedupeScanConditionGroup                                                                                                                | Alternative 1\. When filters.exclude.conditions\[\].type is `"related"`.                                                            |
| `when_brevo_has_value`                   | JSON body             | No                 | `"always"`, `"keep_when_empty"`, `"fill_empty"`                                                                                         |                                                                                                                                     |
| `expected_version`                       | JSON body             | Yes                | string                                                                                                                                  |                                                                                                                                     |

### Response

| HTTP status | Result                                                                |
| ----------- | --------------------------------------------------------------------- |
| `200`       | The requested result. Asynchronous work returns an operation to poll. |

Required fields are required within their containing object. Notes identify fields that apply only to a particular response alternative.

| Response field                                | Type                                                                                                                                                        | Required in object | Notes                                                                                                                                         |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `data`                                        | object                                                                                                                                                      | Yes                |                                                                                                                                               |
| `data.object`                                 | `"brevo_sync_settings"`                                                                                                                                     | Yes                |                                                                                                                                               |
| `data.enabled`                                | boolean                                                                                                                                                     | Yes                |                                                                                                                                               |
| `data.watch`                                  | `"off"`, `"starting"`, `"on"`, `"unavailable"`, `"reconnect_required"`                                                                                      | Yes                |                                                                                                                                               |
| `data.filters`                                | object                                                                                                                                                      | Yes                |                                                                                                                                               |
| `data.filters.include`                        | \_\_schema0 or null                                                                                                                                         | Yes                |                                                                                                                                               |
| `data.filters.include.type`                   | `"and"`, `"or"`                                                                                                                                             | Yes                | Alternative 1.                                                                                                                                |
| `data.filters.include.conditions`             | array of object or \_\_schema0                                                                                                                              | Yes                | Alternative 1.                                                                                                                                |
| `data.filters.include.conditions[].type`      | `"attribute"`                                                                                                                                               | Yes                | Alternative 1\. When data.filters.include.conditions\[\].type is `"attribute"`.                                                               |
| `data.filters.include.conditions[].attribute` | string                                                                                                                                                      | Yes                | Alternative 1\. When data.filters.include.conditions\[\].type is `"attribute"`. When data.filters.include.conditions\[\].type is `"related"`. |
| `data.filters.include.conditions[].operator`  | `"is"`, `"is_not"`, `"contains"`, `"not_contains"`, `"lt"`, `"lte"`, `"gt"`, `"gte"`, `"any_of"`, `"none_of"`, `"empty"`, `"not_empty"`                     | Yes                | Alternative 1\. When data.filters.include.conditions\[\].type is `"attribute"`.                                                               |
| `data.filters.include.conditions[].value`     | string or number or boolean or array of string                                                                                                              | No                 | Alternative 1\. When data.filters.include.conditions\[\].type is `"attribute"`.                                                               |
| `data.filters.include.conditions[].type`      | `"related"`                                                                                                                                                 | Yes                | Alternative 1\. When data.filters.include.conditions\[\].type is `"related"`.                                                                 |
| `data.filters.include.conditions[].object`    | string                                                                                                                                                      | Yes                | Alternative 1\. When data.filters.include.conditions\[\].type is `"related"`.                                                                 |
| `data.filters.include.conditions[].where`     | \_\_schema0                                                                                                                                                 | Yes                | Alternative 1\. When data.filters.include.conditions\[\].type is `"related"`.                                                                 |
| `data.filters.exclude`                        | \_\_schema0 or null                                                                                                                                         | Yes                |                                                                                                                                               |
| `data.filters.exclude.type`                   | `"and"`, `"or"`                                                                                                                                             | Yes                | Alternative 1.                                                                                                                                |
| `data.filters.exclude.conditions`             | array of object or \_\_schema0                                                                                                                              | Yes                | Alternative 1.                                                                                                                                |
| `data.filters.exclude.conditions[].type`      | `"attribute"`                                                                                                                                               | Yes                | Alternative 1\. When data.filters.exclude.conditions\[\].type is `"attribute"`.                                                               |
| `data.filters.exclude.conditions[].attribute` | string                                                                                                                                                      | Yes                | Alternative 1\. When data.filters.exclude.conditions\[\].type is `"attribute"`. When data.filters.exclude.conditions\[\].type is `"related"`. |
| `data.filters.exclude.conditions[].operator`  | `"is"`, `"is_not"`, `"contains"`, `"not_contains"`, `"lt"`, `"lte"`, `"gt"`, `"gte"`, `"any_of"`, `"none_of"`, `"empty"`, `"not_empty"`                     | Yes                | Alternative 1\. When data.filters.exclude.conditions\[\].type is `"attribute"`.                                                               |
| `data.filters.exclude.conditions[].value`     | string or number or boolean or array of string                                                                                                              | No                 | Alternative 1\. When data.filters.exclude.conditions\[\].type is `"attribute"`.                                                               |
| `data.filters.exclude.conditions[].type`      | `"related"`                                                                                                                                                 | Yes                | Alternative 1\. When data.filters.exclude.conditions\[\].type is `"related"`.                                                                 |
| `data.filters.exclude.conditions[].object`    | string                                                                                                                                                      | Yes                | Alternative 1\. When data.filters.exclude.conditions\[\].type is `"related"`.                                                                 |
| `data.filters.exclude.conditions[].where`     | \_\_schema0                                                                                                                                                 | Yes                | Alternative 1\. When data.filters.exclude.conditions\[\].type is `"related"`.                                                                 |
| `data.latest_run`                             | object or null                                                                                                                                              | Yes                |                                                                                                                                               |
| `data.latest_run.object`                      | `"brevo_sync_run"`                                                                                                                                          | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.id`                          | string                                                                                                                                                      | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.state`                       | `"running"`, `"finished"`, `"stopped"`                                                                                                                      | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.sent`                        | integer                                                                                                                                                     | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.skipped`                     | integer                                                                                                                                                     | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.failed`                      | integer                                                                                                                                                     | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.started_at`                  | string                                                                                                                                                      | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.finished_at`                 | string or null                                                                                                                                              | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.stop`                        | object or null                                                                                                                                              | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.stop.setting`                | `"mappings"`, `"filters"`                                                                                                                                   | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.stop.problem`                | `"attio_missing"`, `"provider_missing"`, `"type_changed"`, `"duplicate"`, `"email_attribute"`, `"contact_id_attribute"`, `"changed"`, `"filter"`, `"other"` | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.stop.attio_attribute_id`     | string or null                                                                                                                                              | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.stop.brevo_attribute`        | string or null                                                                                                                                              | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.stop.filter`                 | object or null                                                                                                                                              | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.stop.filter.group`           | `"include"`, `"exclude"`                                                                                                                                    | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1\. Alternative 1.                                                             |
| `data.latest_run.stop.filter.attribute`       | string                                                                                                                                                      | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1\. Alternative 1.                                                             |
| `data.latest_run.stop.filter.object`          | string                                                                                                                                                      | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1\. Alternative 1.                                                             |
| `data.latest_run.undo`                        | object or null                                                                                                                                              | Yes                | When data.latest_run.object is `"brevo_sync_run"`.                                                                                            |
| `data.latest_run.undo.state`                  | `"available"`, `"running"`, `"finished"`                                                                                                                    | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.undo.contacts`               | integer                                                                                                                                                     | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.undo.restored`               | integer                                                                                                                                                     | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.undo.changed`                | integer                                                                                                                                                     | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.latest_run.undo.failed`                 | integer                                                                                                                                                     | Yes                | When data.latest_run.object is `"brevo_sync_run"`. Alternative 1.                                                                             |
| `data.when_brevo_has_value`                   | `"always"`, `"keep_when_empty"`, `"fill_empty"`                                                                                                             | Yes                |                                                                                                                                               |
| `data.version`                                | string                                                                                                                                                      | Yes                |                                                                                                                                               |

### Errors

| HTTP status | Meaning                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | One of: credential_in_url, invalid_parameter, unknown_parameter.                                                                                  |
| `401`       | One of: missing_credential, invalid_credential, credential_expired, credential_revoked.                                                           |
| `402`       | One of: payment_overdue.                                                                                                                          |
| `403`       | The current permissions, plan or policy do not allow this request.                                                                                |
| `404`       | One of: not_found.                                                                                                                                |
| `409`       | The request conflicts with current resource state, authorization or an earlier request. Read the error code and current resource before retrying. |
| `410`       | The requested resource or retained recovery data has expired.                                                                                     |
| `412`       | One of: version_conflict.                                                                                                                         |
| `413`       | One of: request_too_large.                                                                                                                        |
| `422`       | A field, filter or selection cannot be used for this request.                                                                                     |
| `423`       | One of: organization_reopening.                                                                                                                   |
| `428`       | One of: customer_agreement_required.                                                                                                              |
| `429`       | One of: rate_limited.                                                                                                                             |
| `503`       | One of: service_unavailable.                                                                                                                      |

See [errors and recovery](https://neondeerdata.com/docs/api/errors/) and [safe retries](https://neondeerdata.com/docs/api/requests/) before repeating a write.

## List attributes for Brevo filters

```http
GET /v1/brevo-integration/sync-attributes

```

Lists the People attributes a filter condition may name, with the comparisons each takes and the objects a record reference points to. With object, the attributes of that object, which a related condition group follows into from People. search keeps the attributes whose name contains it, in any letter case. Send attribute (a slug) for that one attribute with its options, which a condition names by id; the list leaves options out. Read from Attio now.

Requires `brevo:config:read`. The connection also needs access to the relevant tables, objects, or workflows.

MCP action: `list_brevo_sync_attributes`. Its arguments use the names below, except fields marked REST only. An HTTP header is passed using its argument name in MCP.

### Parameters

| Name        | Send in | Required | Type or allowed values | Notes |
| ----------- | ------- | -------- | ---------------------- | ----- |
| `object`    | query   | No       | string                 |       |
| `search`    | query   | No       | string                 |       |
| `attribute` | query   | No       | string                 |       |

### Response

| HTTP status | Result                                                                |
| ----------- | --------------------------------------------------------------------- |
| `200`       | The requested result. Asynchronous work returns an operation to poll. |

Required fields are required within their containing object. Notes identify fields that apply only to a particular response alternative.

| Response field                      | Type                                                                                                                                             | Required in object | Notes          |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | -------------- |
| `data`                              | object                                                                                                                                           | Yes                |                |
| `data.object`                       | `"brevo_sync_attributes"`                                                                                                                        | Yes                |                |
| `data.attributes_of`                | string                                                                                                                                           | Yes                |                |
| `data.attributes`                   | array of object                                                                                                                                  | Yes                |                |
| `data.attributes[].slug`            | string                                                                                                                                           | Yes                |                |
| `data.attributes[].title`           | string                                                                                                                                           | Yes                |                |
| `data.attributes[].kind`            | `"text"`, `"number"`, `"date"`, `"timestamp"`, `"checkbox"`, `"option"`, `"record"`                                                              | Yes                |                |
| `data.attributes[].multiselect`     | boolean                                                                                                                                          | Yes                |                |
| `data.attributes[].operators`       | array of `"is"`, `"is_not"`, `"contains"`, `"not_contains"`, `"lt"`, `"lte"`, `"gt"`, `"gte"`, `"any_of"`, `"none_of"`, `"empty"`, `"not_empty"` | Yes                |                |
| `data.attributes[].targets`         | array of string or null                                                                                                                          | Yes                |                |
| `data.attributes[].options`         | array of object or null                                                                                                                          | No                 |                |
| `data.attributes[].options[].id`    | string                                                                                                                                           | Yes                | Alternative 1. |
| `data.attributes[].options[].title` | string                                                                                                                                           | Yes                | Alternative 1. |

### Errors

| HTTP status | Meaning                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | One of: credential_in_url, invalid_parameter, unknown_parameter, invalid_request, invalid_cursor.                                                 |
| `401`       | One of: missing_credential, invalid_credential, credential_expired, credential_revoked.                                                           |
| `402`       | One of: payment_overdue.                                                                                                                          |
| `403`       | The current permissions, plan or policy do not allow this request.                                                                                |
| `404`       | One of: not_found.                                                                                                                                |
| `409`       | The request conflicts with current resource state, authorization or an earlier request. Read the error code and current resource before retrying. |
| `410`       | The requested resource or retained recovery data has expired.                                                                                     |
| `412`       | One of: version_conflict.                                                                                                                         |
| `413`       | One of: request_too_large.                                                                                                                        |
| `422`       | A field, filter or selection cannot be used for this request.                                                                                     |
| `423`       | One of: organization_reopening.                                                                                                                   |
| `428`       | One of: customer_agreement_required.                                                                                                              |
| `429`       | One of: rate_limited.                                                                                                                             |
| `503`       | One of: service_unavailable.                                                                                                                      |

See [errors and recovery](https://neondeerdata.com/docs/api/errors/) and [safe retries](https://neondeerdata.com/docs/api/requests/) before repeating a write.

## Update all Brevo contacts now

```http
POST /v1/brevo-integration/sync-runs

```

Sends every Person in Attio that passes the filters to its matching Brevo contact now, with the contact settings. Contacts are updated, never created or removed. While an update is running, this answers that update with started false instead of starting another. Follow it with get_brevo_sync_run.

Requires `brevo:execute`. The connection also needs access to the relevant tables, objects, or workflows.

MCP action: `start_brevo_full_sync`. Its arguments use the names below, except fields marked REST only. An HTTP header is passed using its argument name in MCP.

### Parameters

| Name          | Send in                   | Required | Type or allowed values | Notes |
| ------------- | ------------------------- | -------- | ---------------------- | ----- |
| `request_key` | Header: `Idempotency-Key` | Yes      | string                 |       |

### Response

| HTTP status | Result                                                                |
| ----------- | --------------------------------------------------------------------- |
| `202`       | The requested result. Asynchronous work returns an operation to poll. |

Required fields are required within their containing object. Notes identify fields that apply only to a particular response alternative.

| Response field                 | Type                                                                                                                                                        | Required in object | Notes                          |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------------------------ |
| `data`                         | object                                                                                                                                                      | Yes                |                                |
| `data.object`                  | `"brevo_sync_run"`                                                                                                                                          | Yes                |                                |
| `data.id`                      | string                                                                                                                                                      | Yes                |                                |
| `data.state`                   | `"running"`, `"finished"`, `"stopped"`                                                                                                                      | Yes                |                                |
| `data.sent`                    | integer                                                                                                                                                     | Yes                |                                |
| `data.skipped`                 | integer                                                                                                                                                     | Yes                |                                |
| `data.failed`                  | integer                                                                                                                                                     | Yes                |                                |
| `data.started_at`              | string                                                                                                                                                      | Yes                |                                |
| `data.finished_at`             | string or null                                                                                                                                              | Yes                |                                |
| `data.stop`                    | object or null                                                                                                                                              | Yes                |                                |
| `data.stop.setting`            | `"mappings"`, `"filters"`                                                                                                                                   | Yes                | Alternative 1.                 |
| `data.stop.problem`            | `"attio_missing"`, `"provider_missing"`, `"type_changed"`, `"duplicate"`, `"email_attribute"`, `"contact_id_attribute"`, `"changed"`, `"filter"`, `"other"` | Yes                | Alternative 1.                 |
| `data.stop.attio_attribute_id` | string or null                                                                                                                                              | Yes                | Alternative 1.                 |
| `data.stop.brevo_attribute`    | string or null                                                                                                                                              | Yes                | Alternative 1.                 |
| `data.stop.filter`             | object or null                                                                                                                                              | Yes                | Alternative 1.                 |
| `data.stop.filter.group`       | `"include"`, `"exclude"`                                                                                                                                    | Yes                | Alternative 1\. Alternative 1. |
| `data.stop.filter.attribute`   | string                                                                                                                                                      | Yes                | Alternative 1\. Alternative 1. |
| `data.stop.filter.object`      | string                                                                                                                                                      | Yes                | Alternative 1\. Alternative 1. |
| `data.undo`                    | object or null                                                                                                                                              | Yes                |                                |
| `data.undo.state`              | `"available"`, `"running"`, `"finished"`                                                                                                                    | Yes                | Alternative 1.                 |
| `data.undo.contacts`           | integer                                                                                                                                                     | Yes                | Alternative 1.                 |
| `data.undo.restored`           | integer                                                                                                                                                     | Yes                | Alternative 1.                 |
| `data.undo.changed`            | integer                                                                                                                                                     | Yes                | Alternative 1.                 |
| `data.undo.failed`             | integer                                                                                                                                                     | Yes                | Alternative 1.                 |
| `started`                      | boolean                                                                                                                                                     | Yes                |                                |

Accepted work can continue after the request returns. Follow its returned status or operation until it finishes; accepting work does not mean every item succeeded. See [operation status](https://neondeerdata.com/docs/api/operations/).

### Errors

| HTTP status | Meaning                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | One of: credential_in_url, invalid_parameter, unknown_parameter, invalid_request.                                                                 |
| `401`       | One of: missing_credential, invalid_credential, credential_expired, credential_revoked.                                                           |
| `402`       | One of: payment_overdue.                                                                                                                          |
| `403`       | The current permissions, plan or policy do not allow this request.                                                                                |
| `404`       | One of: not_found.                                                                                                                                |
| `409`       | The request conflicts with current resource state, authorization or an earlier request. Read the error code and current resource before retrying. |
| `410`       | The requested resource or retained recovery data has expired.                                                                                     |
| `412`       | One of: version_conflict.                                                                                                                         |
| `413`       | One of: request_too_large.                                                                                                                        |
| `422`       | A field, filter or selection cannot be used for this request.                                                                                     |
| `423`       | One of: organization_reopening.                                                                                                                   |
| `428`       | One of: customer_agreement_required.                                                                                                              |
| `429`       | One of: rate_limited.                                                                                                                             |
| `503`       | One of: service_unavailable.                                                                                                                      |

See [errors and recovery](https://neondeerdata.com/docs/api/errors/) and [safe retries](https://neondeerdata.com/docs/api/requests/) before repeating a write.

## Get an update of all Brevo contacts

```http
GET /v1/brevo-integration/sync-runs/{run_id}

```

Gets an update's progress: running, finished or stopped, and how many People were sent, skipped or could not be confirmed. When a saved mapping or filter stopped the update, stop says which and why: fix it and start the update again, or just start it again when they only changed while it ran. Only the latest update is kept.

Requires `brevo:config:read`. The connection also needs access to the relevant tables, objects, or workflows.

MCP action: `get_brevo_sync_run`. Its arguments use the names below, except fields marked REST only. An HTTP header is passed using its argument name in MCP.

### Parameters

| Name     | Send in | Required | Type or allowed values | Notes |
| -------- | ------- | -------- | ---------------------- | ----- |
| `run_id` | path    | Yes      | string (uuid)          |       |

### Response

| HTTP status | Result                                                                |
| ----------- | --------------------------------------------------------------------- |
| `200`       | The requested result. Asynchronous work returns an operation to poll. |

Required fields are required within their containing object. Notes identify fields that apply only to a particular response alternative.

| Response field                 | Type                                                                                                                                                        | Required in object | Notes                          |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------------------------ |
| `data`                         | object                                                                                                                                                      | Yes                |                                |
| `data.object`                  | `"brevo_sync_run"`                                                                                                                                          | Yes                |                                |
| `data.id`                      | string                                                                                                                                                      | Yes                |                                |
| `data.state`                   | `"running"`, `"finished"`, `"stopped"`                                                                                                                      | Yes                |                                |
| `data.sent`                    | integer                                                                                                                                                     | Yes                |                                |
| `data.skipped`                 | integer                                                                                                                                                     | Yes                |                                |
| `data.failed`                  | integer                                                                                                                                                     | Yes                |                                |
| `data.started_at`              | string                                                                                                                                                      | Yes                |                                |
| `data.finished_at`             | string or null                                                                                                                                              | Yes                |                                |
| `data.stop`                    | object or null                                                                                                                                              | Yes                |                                |
| `data.stop.setting`            | `"mappings"`, `"filters"`                                                                                                                                   | Yes                | Alternative 1.                 |
| `data.stop.problem`            | `"attio_missing"`, `"provider_missing"`, `"type_changed"`, `"duplicate"`, `"email_attribute"`, `"contact_id_attribute"`, `"changed"`, `"filter"`, `"other"` | Yes                | Alternative 1.                 |
| `data.stop.attio_attribute_id` | string or null                                                                                                                                              | Yes                | Alternative 1.                 |
| `data.stop.brevo_attribute`    | string or null                                                                                                                                              | Yes                | Alternative 1.                 |
| `data.stop.filter`             | object or null                                                                                                                                              | Yes                | Alternative 1.                 |
| `data.stop.filter.group`       | `"include"`, `"exclude"`                                                                                                                                    | Yes                | Alternative 1\. Alternative 1. |
| `data.stop.filter.attribute`   | string                                                                                                                                                      | Yes                | Alternative 1\. Alternative 1. |
| `data.stop.filter.object`      | string                                                                                                                                                      | Yes                | Alternative 1\. Alternative 1. |
| `data.undo`                    | object or null                                                                                                                                              | Yes                |                                |
| `data.undo.state`              | `"available"`, `"running"`, `"finished"`                                                                                                                    | Yes                | Alternative 1.                 |
| `data.undo.contacts`           | integer                                                                                                                                                     | Yes                | Alternative 1.                 |
| `data.undo.restored`           | integer                                                                                                                                                     | Yes                | Alternative 1.                 |
| `data.undo.changed`            | integer                                                                                                                                                     | Yes                | Alternative 1.                 |
| `data.undo.failed`             | integer                                                                                                                                                     | Yes                | Alternative 1.                 |

### Errors

| HTTP status | Meaning                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | One of: credential_in_url, invalid_parameter, unknown_parameter.                                                                                  |
| `401`       | One of: missing_credential, invalid_credential, credential_expired, credential_revoked.                                                           |
| `402`       | One of: payment_overdue.                                                                                                                          |
| `403`       | The current permissions, plan or policy do not allow this request.                                                                                |
| `404`       | One of: not_found.                                                                                                                                |
| `409`       | The request conflicts with current resource state, authorization or an earlier request. Read the error code and current resource before retrying. |
| `410`       | The requested resource or retained recovery data has expired.                                                                                     |
| `412`       | One of: version_conflict.                                                                                                                         |
| `413`       | One of: request_too_large.                                                                                                                        |
| `422`       | A field, filter or selection cannot be used for this request.                                                                                     |
| `423`       | One of: organization_reopening.                                                                                                                   |
| `428`       | One of: customer_agreement_required.                                                                                                              |
| `429`       | One of: rate_limited.                                                                                                                             |
| `503`       | One of: service_unavailable.                                                                                                                      |

See [errors and recovery](https://neondeerdata.com/docs/api/errors/) and [safe retries](https://neondeerdata.com/docs/api/requests/) before repeating a write.

## Undo an update of all Brevo contacts

```http
POST /v1/brevo-integration/sync-runs/{run_id}/undo

```

Puts back the Brevo values every contact update of an update of all contacts replaced. An attribute changed in Brevo since is left as it is. Attio still has the new values, so the next change to a Person in Attio sends them again. The undo is queued; follow it with get_brevo_sync_run.

Requires `brevo:execute`. The connection also needs access to the relevant tables, objects, or workflows.

MCP action: `restore_brevo_sync_run`. Its arguments use the names below, except fields marked REST only. An HTTP header is passed using its argument name in MCP.

### Parameters

| Name     | Send in | Required | Type or allowed values | Notes |
| -------- | ------- | -------- | ---------------------- | ----- |
| `run_id` | path    | Yes      | string (uuid)          |       |

### Response

| HTTP status | Result                                                                |
| ----------- | --------------------------------------------------------------------- |
| `202`       | The requested result. Asynchronous work returns an operation to poll. |

Required fields are required within their containing object. Notes identify fields that apply only to a particular response alternative.

| Response field | Type   | Required in object | Notes |
| -------------- | ------ | ------------------ | ----- |
| `queued`       | `true` | Yes                |       |

Accepted work can continue after the request returns. Follow its returned status or operation until it finishes; accepting work does not mean every item succeeded. See [operation status](https://neondeerdata.com/docs/api/operations/).

### Errors

| HTTP status | Meaning                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | One of: credential_in_url, invalid_parameter, unknown_parameter.                                                                                  |
| `401`       | One of: missing_credential, invalid_credential, credential_expired, credential_revoked.                                                           |
| `402`       | One of: payment_overdue.                                                                                                                          |
| `403`       | The current permissions, plan or policy do not allow this request.                                                                                |
| `404`       | One of: not_found.                                                                                                                                |
| `409`       | The request conflicts with current resource state, authorization or an earlier request. Read the error code and current resource before retrying. |
| `410`       | The requested resource or retained recovery data has expired.                                                                                     |
| `412`       | One of: version_conflict.                                                                                                                         |
| `413`       | One of: request_too_large.                                                                                                                        |
| `422`       | A field, filter or selection cannot be used for this request.                                                                                     |
| `423`       | One of: organization_reopening.                                                                                                                   |
| `428`       | One of: customer_agreement_required.                                                                                                              |
| `429`       | One of: rate_limited.                                                                                                                             |
| `503`       | One of: service_unavailable.                                                                                                                      |

See [errors and recovery](https://neondeerdata.com/docs/api/errors/) and [safe retries](https://neondeerdata.com/docs/api/requests/) before repeating a write.

## Get what a Brevo contact update changed

```http
GET /v1/brevo-integration/activity/{update_id}/changes

```

Gets what one contact update (a list_brevo_activity entry whose undo is not null) changed on its Brevo contact: each Brevo attribute it changed and what an undo did. The values before and after are shown in Brevo activity in Neon Deer. available is false once it can no longer be undone.

Requires `brevo:config:read`. The connection also needs access to the relevant tables, objects, or workflows.

MCP action: `get_brevo_contact_update_changes`. Its arguments use the names below, except fields marked REST only. An HTTP header is passed using its argument name in MCP.

### Parameters

| Name        | Send in | Required | Type or allowed values | Notes |
| ----------- | ------- | -------- | ---------------------- | ----- |
| `update_id` | path    | Yes      | string (uuid)          |       |

### Response

| HTTP status | Result                                                                |
| ----------- | --------------------------------------------------------------------- |
| `200`       | The requested result. Asynchronous work returns an operation to poll. |

Required fields are required within their containing object. Notes identify fields that apply only to a particular response alternative.

| Response field             | Type                                          | Required in object | Notes |
| -------------------------- | --------------------------------------------- | ------------------ | ----- |
| `data`                     | object                                        | Yes                |       |
| `data.object`              | `"brevo_contact_update_changes"`              | Yes                |       |
| `data.update_id`           | string                                        | Yes                |       |
| `data.record_id`           | string                                        | Yes                |       |
| `data.contact_id`          | integer                                       | Yes                |       |
| `data.run_id`              | string or null                                | Yes                |       |
| `data.at`                  | string                                        | Yes                |       |
| `data.available`           | boolean                                       | Yes                |       |
| `data.changes`             | array of object                               | Yes                |       |
| `data.changes[].attribute` | string                                        | Yes                |       |
| `data.changes[].undo`      | `"restored"`, `"changed"`, `"failed"` or null | Yes                |       |

### Errors

| HTTP status | Meaning                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | One of: credential_in_url, invalid_parameter, unknown_parameter.                                                                                  |
| `401`       | One of: missing_credential, invalid_credential, credential_expired, credential_revoked.                                                           |
| `402`       | One of: payment_overdue.                                                                                                                          |
| `403`       | The current permissions, plan or policy do not allow this request.                                                                                |
| `404`       | One of: not_found.                                                                                                                                |
| `409`       | The request conflicts with current resource state, authorization or an earlier request. Read the error code and current resource before retrying. |
| `410`       | The requested resource or retained recovery data has expired.                                                                                     |
| `412`       | One of: version_conflict.                                                                                                                         |
| `413`       | One of: request_too_large.                                                                                                                        |
| `422`       | A field, filter or selection cannot be used for this request.                                                                                     |
| `423`       | One of: organization_reopening.                                                                                                                   |
| `428`       | One of: customer_agreement_required.                                                                                                              |
| `429`       | One of: rate_limited.                                                                                                                             |
| `503`       | One of: service_unavailable.                                                                                                                      |

See [errors and recovery](https://neondeerdata.com/docs/api/errors/) and [safe retries](https://neondeerdata.com/docs/api/requests/) before repeating a write.

## Undo a Brevo contact update

```http
POST /v1/brevo-integration/activity/{update_id}/undo

```

Puts back the Brevo values a contact update replaced, for every attribute it changed or the attributes named (Brevo attribute names from get_brevo_contact_update_changes). An attribute changed in Brevo since is left as it is. Attio still has the new values, so the next change to the Person in Attio sends them again. The undo is queued; follow it with get_brevo_contact_update_changes.

Requires `brevo:execute`. The connection also needs access to the relevant tables, objects, or workflows.

MCP action: `restore_brevo_contact_update`. Its arguments use the names below, except fields marked REST only. An HTTP header is passed using its argument name in MCP.

### Parameters

| Name         | Send in   | Required | Type or allowed values | Notes |
| ------------ | --------- | -------- | ---------------------- | ----- |
| `update_id`  | path      | Yes      | string (uuid)          |       |
| `attributes` | JSON body | No       | array of string        |       |

### Response

| HTTP status | Result                                                                |
| ----------- | --------------------------------------------------------------------- |
| `202`       | The requested result. Asynchronous work returns an operation to poll. |

Required fields are required within their containing object. Notes identify fields that apply only to a particular response alternative.

| Response field | Type   | Required in object | Notes |
| -------------- | ------ | ------------------ | ----- |
| `queued`       | `true` | Yes                |       |

Accepted work can continue after the request returns. Follow its returned status or operation until it finishes; accepting work does not mean every item succeeded. See [operation status](https://neondeerdata.com/docs/api/operations/).

### Errors

| HTTP status | Meaning                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | One of: credential_in_url, invalid_parameter, unknown_parameter.                                                                                  |
| `401`       | One of: missing_credential, invalid_credential, credential_expired, credential_revoked.                                                           |
| `402`       | One of: payment_overdue.                                                                                                                          |
| `403`       | The current permissions, plan or policy do not allow this request.                                                                                |
| `404`       | One of: not_found.                                                                                                                                |
| `409`       | The request conflicts with current resource state, authorization or an earlier request. Read the error code and current resource before retrying. |
| `410`       | The requested resource or retained recovery data has expired.                                                                                     |
| `412`       | One of: version_conflict.                                                                                                                         |
| `413`       | One of: request_too_large.                                                                                                                        |
| `422`       | A field, filter or selection cannot be used for this request.                                                                                     |
| `423`       | One of: organization_reopening.                                                                                                                   |
| `428`       | One of: customer_agreement_required.                                                                                                              |
| `429`       | One of: rate_limited.                                                                                                                             |
| `503`       | One of: service_unavailable.                                                                                                                      |

See [errors and recovery](https://neondeerdata.com/docs/api/errors/) and [safe retries](https://neondeerdata.com/docs/api/requests/) before repeating a write.

## List attributes to map with Brevo

```http
GET /v1/brevo-integration/contact-attributes

```

Lists the People attributes that can be mapped to Brevo contact attributes, with each side's type; the objects People point to, whose attributes can be mapped too; the People text attributes that can hold the Brevo contact id; and the People email attributes that can choose a Person's Brevo contact. With object (from related_objects), the attio list holds that object's attributes instead of People's. search keeps the Attio and Brevo attributes whose name contains it, in any letter case. Send include_options true for each select attribute's options, to map one select to another. Read from Attio and Brevo now.

Requires `brevo:config:read`. The connection also needs access to the relevant tables, objects, or workflows.

MCP action: `list_brevo_contact_attributes`. Its arguments use the names below, except fields marked REST only. An HTTP header is passed using its argument name in MCP.

### Parameters

| Name              | Send in | Required | Type or allowed values | Notes                                  |
| ----------------- | ------- | -------- | ---------------------- | -------------------------------------- |
| `object`          | query   | No       | string                 |                                        |
| `search`          | query   | No       | string                 |                                        |
| `include_options` | query   | No       | boolean                | Use true or false in the query string. |

### Response

| HTTP status | Result                                                                |
| ----------- | --------------------------------------------------------------------- |
| `200`       | The requested result. Asynchronous work returns an operation to poll. |

Required fields are required within their containing object. Notes identify fields that apply only to a particular response alternative.

| Response field                       | Type                                                                                                                                          | Required in object | Notes          |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | -------------- |
| `data`                               | object                                                                                                                                        | Yes                |                |
| `data.object`                        | `"brevo_contact_attributes"`                                                                                                                  | Yes                |                |
| `data.attio`                         | array of object                                                                                                                               | Yes                |                |
| `data.attio[].id`                    | string                                                                                                                                        | Yes                |                |
| `data.attio[].slug`                  | string                                                                                                                                        | Yes                |                |
| `data.attio[].title`                 | string                                                                                                                                        | Yes                |                |
| `data.attio[].kind`                  | `"text"`, `"number"`, `"checkbox"`, `"select"`, `"status"`, `"location"`                                                                      | Yes                |                |
| `data.attio[].location_part`         | `"line_1"`, `"line_2"`, `"line_3"`, `"line_4"`, `"locality"`, `"region"`, `"postcode"`, `"country_code"`, `"latitude"`, `"longitude"` or null | Yes                |                |
| `data.attio[].name_part`             | `"full_name"`, `"first_name"`, `"last_name"` or null                                                                                          | Yes                |                |
| `data.attio[].multiselect`           | boolean                                                                                                                                       | Yes                |                |
| `data.attio[].writable`              | boolean                                                                                                                                       | Yes                |                |
| `data.attio[].options`               | array of string or null                                                                                                                       | No                 |                |
| `data.attio[].relation`              | object or null                                                                                                                                | Yes                |                |
| `data.attio[].relation.attribute_id` | string                                                                                                                                        | Yes                | Alternative 1. |
| `data.attio[].relation.object_id`    | string                                                                                                                                        | Yes                | Alternative 1. |
| `data.attio[].relation.title`        | string                                                                                                                                        | Yes                | Alternative 1. |
| `data.attio[].relation.object_title` | string                                                                                                                                        | Yes                | Alternative 1. |
| `data.related_objects`               | array of object                                                                                                                               | Yes                |                |
| `data.related_objects[].object`      | string                                                                                                                                        | Yes                |                |
| `data.related_objects[].title`       | string                                                                                                                                        | Yes                |                |
| `data.brevo`                         | array of object                                                                                                                               | Yes                |                |
| `data.brevo[].name`                  | string                                                                                                                                        | Yes                |                |
| `data.brevo[].category`              | string                                                                                                                                        | Yes                |                |
| `data.brevo[].type`                  | string or null                                                                                                                                | Yes                |                |
| `data.brevo[].options`               | array of string or null                                                                                                                       | No                 |                |
| `data.contact_id_attributes`         | array of object                                                                                                                               | Yes                |                |
| `data.contact_id_attributes[].id`    | string                                                                                                                                        | Yes                |                |
| `data.contact_id_attributes[].title` | string                                                                                                                                        | Yes                |                |
| `data.email_attributes`              | array of object                                                                                                                               | Yes                |                |
| `data.email_attributes[].id`         | string                                                                                                                                        | Yes                |                |
| `data.email_attributes[].title`      | string                                                                                                                                        | Yes                |                |

### Errors

| HTTP status | Meaning                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | One of: credential_in_url, invalid_parameter, unknown_parameter, invalid_request, invalid_cursor.                                                 |
| `401`       | One of: missing_credential, invalid_credential, credential_expired, credential_revoked.                                                           |
| `402`       | One of: payment_overdue.                                                                                                                          |
| `403`       | The current permissions, plan or policy do not allow this request.                                                                                |
| `404`       | One of: not_found.                                                                                                                                |
| `409`       | The request conflicts with current resource state, authorization or an earlier request. Read the error code and current resource before retrying. |
| `410`       | The requested resource or retained recovery data has expired.                                                                                     |
| `412`       | One of: version_conflict.                                                                                                                         |
| `413`       | One of: request_too_large.                                                                                                                        |
| `422`       | A field, filter or selection cannot be used for this request.                                                                                     |
| `423`       | One of: organization_reopening.                                                                                                                   |
| `428`       | One of: customer_agreement_required.                                                                                                              |
| `429`       | One of: rate_limited.                                                                                                                             |
| `503`       | One of: service_unavailable.                                                                                                                      |

See [errors and recovery](https://neondeerdata.com/docs/api/errors/) and [safe retries](https://neondeerdata.com/docs/api/requests/) before repeating a write.

## Get Brevo contact mappings

```http
GET /v1/brevo-integration/contact-mappings

```

Gets which People attributes are mapped to which Brevo contact attributes and in which direction: to_brevo, to_attio or both. contact_id_attribute_id is the People attribute that stores the Brevo contact id. profile_email_attribute_id chooses a Person's Brevo contact: the saved primary contact is used first; otherwise that attribute's current email, and if it is empty the Person is skipped. With no attribute chosen, the first current email is used.

Requires `brevo:config:read`. The connection also needs access to the relevant tables, objects, or workflows.

MCP action: `get_brevo_contact_mappings`. Its arguments use the names below, except fields marked REST only. An HTTP header is passed using its argument name in MCP.

No request parameters are needed.

### Response

| HTTP status | Result                                                                |
| ----------- | --------------------------------------------------------------------- |
| `200`       | The requested result. Asynchronous work returns an operation to poll. |

Required fields are required within their containing object. Notes identify fields that apply only to a particular response alternative.

| Response field                                | Type                                                                                                                                          | Required in object | Notes          |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | -------------- |
| `data`                                        | object                                                                                                                                        | Yes                |                |
| `data.object`                                 | `"brevo_contact_mappings"`                                                                                                                    | Yes                |                |
| `data.mappings`                               | array of object                                                                                                                               | Yes                |                |
| `data.mappings[].attio_attribute_id`          | string                                                                                                                                        | Yes                |                |
| `data.mappings[].attio_relation`              | object or null                                                                                                                                | Yes                |                |
| `data.mappings[].attio_relation.attribute_id` | string                                                                                                                                        | Yes                | Alternative 1. |
| `data.mappings[].attio_relation.object_id`    | string                                                                                                                                        | Yes                | Alternative 1. |
| `data.mappings[].attio_location_part`         | `"line_1"`, `"line_2"`, `"line_3"`, `"line_4"`, `"locality"`, `"region"`, `"postcode"`, `"country_code"`, `"latitude"`, `"longitude"` or null | Yes                |                |
| `data.mappings[].attio_name_part`             | `"full_name"`, `"first_name"`, `"last_name"` or null                                                                                          | Yes                |                |
| `data.mappings[].brevo_attribute`             | string                                                                                                                                        | Yes                |                |
| `data.mappings[].direction`                   | `"to_brevo"`, `"to_attio"`, `"both"`                                                                                                          | Yes                |                |
| `data.contact_id_attribute_id`                | string or null                                                                                                                                | Yes                |                |
| `data.profile_email_attribute_id`             | string or null                                                                                                                                | Yes                |                |
| `data.version`                                | string                                                                                                                                        | Yes                |                |

### Errors

| HTTP status | Meaning                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | One of: credential_in_url, invalid_parameter, unknown_parameter.                                                                                  |
| `401`       | One of: missing_credential, invalid_credential, credential_expired, credential_revoked.                                                           |
| `402`       | One of: payment_overdue.                                                                                                                          |
| `403`       | The current permissions, plan or policy do not allow this request.                                                                                |
| `404`       | One of: not_found.                                                                                                                                |
| `409`       | The request conflicts with current resource state, authorization or an earlier request. Read the error code and current resource before retrying. |
| `410`       | The requested resource or retained recovery data has expired.                                                                                     |
| `412`       | One of: version_conflict.                                                                                                                         |
| `413`       | One of: request_too_large.                                                                                                                        |
| `422`       | A field, filter or selection cannot be used for this request.                                                                                     |
| `423`       | One of: organization_reopening.                                                                                                                   |
| `428`       | One of: customer_agreement_required.                                                                                                              |
| `429`       | One of: rate_limited.                                                                                                                             |
| `503`       | One of: service_unavailable.                                                                                                                      |

See [errors and recovery](https://neondeerdata.com/docs/api/errors/) and [safe retries](https://neondeerdata.com/docs/api/requests/) before repeating a write.

## Replace Brevo contact mappings

```http
PUT /v1/brevo-integration/contact-mappings

```

Replaces every contact mapping, the contact id attribute and the profile email attribute at the version the mappings answered (expected_version). Name attributes from list_brevo_contact_attributes; a related attribute names the People attribute and object it is reached through in attio_relation; a location attribute maps one part at a time, named in attio_location_part, and a personal name too, in attio_name_part. First and last name are sent to Brevo without a mapping; add a Brevo to Attio mapping (to_attio) from FIRSTNAME or LASTNAME to update them in Attio too. Statuses match by title. A new status from Brevo is added to the mapped Attio attribute unless that title is archived; workspace access may need to be reconnected first. Mapping to Attio (to_attio or both) needs a plan that includes updating Attio from Brevo.

Requires `brevo:config:write`. The connection also needs access to the relevant tables, objects, or workflows.

MCP action: `update_brevo_contact_mappings`. Its arguments use the names below, except fields marked REST only. An HTTP header is passed using its argument name in MCP.

### Parameters

| Name                                     | Send in               | Required           | Type or allowed values                                                                                                                        | Notes          |
| ---------------------------------------- | --------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| `mappings`                               | JSON body             | Yes                | array of object                                                                                                                               |                |
| `mappings[].attio_attribute_id`          | Within the JSON value | Within this object | string (uuid)                                                                                                                                 |                |
| `mappings[].attio_relation`              | Within the JSON value | Within this object | object or null                                                                                                                                |                |
| `mappings[].attio_relation.attribute_id` | Within the JSON value | Within this object | string (uuid)                                                                                                                                 | Alternative 1. |
| `mappings[].attio_relation.object_id`    | Within the JSON value | Within this object | string (uuid)                                                                                                                                 | Alternative 1. |
| `mappings[].attio_location_part`         | Within the JSON value | No                 | `"line_1"`, `"line_2"`, `"line_3"`, `"line_4"`, `"locality"`, `"region"`, `"postcode"`, `"country_code"`, `"latitude"`, `"longitude"` or null |                |
| `mappings[].attio_name_part`             | Within the JSON value | No                 | `"full_name"`, `"first_name"`, `"last_name"` or null                                                                                          |                |
| `mappings[].brevo_attribute`             | Within the JSON value | Within this object | string                                                                                                                                        |                |
| `mappings[].direction`                   | Within the JSON value | Within this object | `"to_brevo"`, `"to_attio"`, `"both"`                                                                                                          |                |
| `contact_id_attribute_id`                | JSON body             | Yes                | string (uuid) or null                                                                                                                         |                |
| `profile_email_attribute_id`             | JSON body             | Yes                | string (uuid) or null                                                                                                                         |                |
| `expected_version`                       | JSON body             | Yes                | string                                                                                                                                        |                |

### Response

| HTTP status | Result                                                                |
| ----------- | --------------------------------------------------------------------- |
| `200`       | The requested result. Asynchronous work returns an operation to poll. |

Required fields are required within their containing object. Notes identify fields that apply only to a particular response alternative.

| Response field                                | Type                                                                                                                                          | Required in object | Notes          |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | -------------- |
| `data`                                        | object                                                                                                                                        | Yes                |                |
| `data.object`                                 | `"brevo_contact_mappings"`                                                                                                                    | Yes                |                |
| `data.mappings`                               | array of object                                                                                                                               | Yes                |                |
| `data.mappings[].attio_attribute_id`          | string                                                                                                                                        | Yes                |                |
| `data.mappings[].attio_relation`              | object or null                                                                                                                                | Yes                |                |
| `data.mappings[].attio_relation.attribute_id` | string                                                                                                                                        | Yes                | Alternative 1. |
| `data.mappings[].attio_relation.object_id`    | string                                                                                                                                        | Yes                | Alternative 1. |
| `data.mappings[].attio_location_part`         | `"line_1"`, `"line_2"`, `"line_3"`, `"line_4"`, `"locality"`, `"region"`, `"postcode"`, `"country_code"`, `"latitude"`, `"longitude"` or null | Yes                |                |
| `data.mappings[].attio_name_part`             | `"full_name"`, `"first_name"`, `"last_name"` or null                                                                                          | Yes                |                |
| `data.mappings[].brevo_attribute`             | string                                                                                                                                        | Yes                |                |
| `data.mappings[].direction`                   | `"to_brevo"`, `"to_attio"`, `"both"`                                                                                                          | Yes                |                |
| `data.contact_id_attribute_id`                | string or null                                                                                                                                | Yes                |                |
| `data.profile_email_attribute_id`             | string or null                                                                                                                                | Yes                |                |
| `data.version`                                | string                                                                                                                                        | Yes                |                |

### Errors

| HTTP status | Meaning                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | One of: credential_in_url, invalid_parameter, unknown_parameter.                                                                                  |
| `401`       | One of: missing_credential, invalid_credential, credential_expired, credential_revoked.                                                           |
| `402`       | One of: payment_overdue.                                                                                                                          |
| `403`       | The current permissions, plan or policy do not allow this request.                                                                                |
| `404`       | One of: not_found.                                                                                                                                |
| `409`       | The request conflicts with current resource state, authorization or an earlier request. Read the error code and current resource before retrying. |
| `410`       | The requested resource or retained recovery data has expired.                                                                                     |
| `412`       | One of: version_conflict.                                                                                                                         |
| `413`       | One of: request_too_large.                                                                                                                        |
| `422`       | A field, filter or selection cannot be used for this request.                                                                                     |
| `423`       | One of: organization_reopening.                                                                                                                   |
| `428`       | One of: customer_agreement_required.                                                                                                              |
| `429`       | One of: rate_limited.                                                                                                                             |
| `503`       | One of: service_unavailable.                                                                                                                      |

See [errors and recovery](https://neondeerdata.com/docs/api/errors/) and [safe retries](https://neondeerdata.com/docs/api/requests/) before repeating a write.

## Get incoming Brevo contact updates

```http
GET /v1/brevo-integration/contact-import

```

Gets whether changes to Brevo contacts update the matching People in Attio, and how often Brevo is checked, in minutes. Only People that already exist are updated, with the attributes mapped to Attio.

Requires `brevo:config:read`. The connection also needs access to the relevant tables, objects, or workflows.

MCP action: `get_brevo_contact_import`. Its arguments use the names below, except fields marked REST only. An HTTP header is passed using its argument name in MCP.

No request parameters are needed.

### Response

| HTTP status | Result                                                                |
| ----------- | --------------------------------------------------------------------- |
| `200`       | The requested result. Asynchronous work returns an operation to poll. |

Required fields are required within their containing object. Notes identify fields that apply only to a particular response alternative.

| Response field               | Type                     | Required in object | Notes |
| ---------------------------- | ------------------------ | ------------------ | ----- |
| `data`                       | object                   | Yes                |       |
| `data.object`                | `"brevo_contact_import"` | Yes                |       |
| `data.enabled`               | boolean                  | Yes                |       |
| `data.poll_interval_minutes` | integer                  | Yes                |       |
| `data.version`               | string                   | Yes                |       |

### Errors

| HTTP status | Meaning                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | One of: credential_in_url, invalid_parameter, unknown_parameter.                                                                                  |
| `401`       | One of: missing_credential, invalid_credential, credential_expired, credential_revoked.                                                           |
| `402`       | One of: payment_overdue.                                                                                                                          |
| `403`       | The current permissions, plan or policy do not allow this request.                                                                                |
| `404`       | One of: not_found.                                                                                                                                |
| `409`       | The request conflicts with current resource state, authorization or an earlier request. Read the error code and current resource before retrying. |
| `410`       | The requested resource or retained recovery data has expired.                                                                                     |
| `412`       | One of: version_conflict.                                                                                                                         |
| `413`       | One of: request_too_large.                                                                                                                        |
| `422`       | A field, filter or selection cannot be used for this request.                                                                                     |
| `423`       | One of: organization_reopening.                                                                                                                   |
| `428`       | One of: customer_agreement_required.                                                                                                              |
| `429`       | One of: rate_limited.                                                                                                                             |
| `503`       | One of: service_unavailable.                                                                                                                      |

See [errors and recovery](https://neondeerdata.com/docs/api/errors/) and [safe retries](https://neondeerdata.com/docs/api/requests/) before repeating a write.

## Change incoming Brevo contact updates

```http
PUT /v1/brevo-integration/contact-import

```

Turns updating People from Brevo contacts on or off, and sets how often Brevo is checked: 15, 30, 60, 180, 360 or 1440 minutes, at the version the setting answered (expected_version). Turning it on needs a plan that includes updating Attio from Brevo.

Requires `brevo:config:write`. The connection also needs access to the relevant tables, objects, or workflows.

MCP action: `update_brevo_contact_import`. Its arguments use the names below, except fields marked REST only. An HTTP header is passed using its argument name in MCP.

### Parameters

| Name                    | Send in   | Required | Type or allowed values                 | Notes |
| ----------------------- | --------- | -------- | -------------------------------------- | ----- |
| `enabled`               | JSON body | Yes      | boolean                                |       |
| `poll_interval_minutes` | JSON body | Yes      | `15`, `30`, `60`, `180`, `360`, `1440` |       |
| `expected_version`      | JSON body | Yes      | string                                 |       |

### Response

| HTTP status | Result                                                                |
| ----------- | --------------------------------------------------------------------- |
| `200`       | The requested result. Asynchronous work returns an operation to poll. |

Required fields are required within their containing object. Notes identify fields that apply only to a particular response alternative.

| Response field               | Type                     | Required in object | Notes |
| ---------------------------- | ------------------------ | ------------------ | ----- |
| `data`                       | object                   | Yes                |       |
| `data.object`                | `"brevo_contact_import"` | Yes                |       |
| `data.enabled`               | boolean                  | Yes                |       |
| `data.poll_interval_minutes` | integer                  | Yes                |       |
| `data.version`               | string                   | Yes                |       |

### Errors

| HTTP status | Meaning                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | One of: credential_in_url, invalid_parameter, unknown_parameter.                                                                                  |
| `401`       | One of: missing_credential, invalid_credential, credential_expired, credential_revoked.                                                           |
| `402`       | One of: payment_overdue.                                                                                                                          |
| `403`       | The current permissions, plan or policy do not allow this request.                                                                                |
| `404`       | One of: not_found.                                                                                                                                |
| `409`       | The request conflicts with current resource state, authorization or an earlier request. Read the error code and current resource before retrying. |
| `410`       | The requested resource or retained recovery data has expired.                                                                                     |
| `412`       | One of: version_conflict.                                                                                                                         |
| `413`       | One of: request_too_large.                                                                                                                        |
| `422`       | A field, filter or selection cannot be used for this request.                                                                                     |
| `423`       | One of: organization_reopening.                                                                                                                   |
| `428`       | One of: customer_agreement_required.                                                                                                              |
| `429`       | One of: rate_limited.                                                                                                                             |
| `503`       | One of: service_unavailable.                                                                                                                      |

See [errors and recovery](https://neondeerdata.com/docs/api/errors/) and [safe retries](https://neondeerdata.com/docs/api/requests/) before repeating a write.

The [public OpenAPI document](https://neondeerdata.com/docs/api/meta/openapi/) lists generally available API families. Alpha operations may not appear in that document; their request and response fields are listed on this page. Use the [API Playground](https://neondeerdata.com/docs/api/testing/) to inspect a real response with your connection's access.
