Brevo activity
Read contact and message activity with the recorded source and outcome.
The APIs on this page require alpha access for your organization. App availability and API access are separate. Check access and permissions.
List Brevo activity
GET /v1/brevo-integration/activity
Lists recent contact updates and message Activities between Attio and Brevo, latest first, with totals by status: their direction, status, the Person's record id, which attributes a contact update changed (by id), the list a list add was for, the template an email was sent from, why one was skipped, who or what started it, and a message's channel and event. A message Activity Attio never confirmed has status outcome_unknown and is never sent again. No email address, phone number or message content is returned. kind, channel, direction, status and started_by narrow the list. Send next_cursor as cursor, with the same filters, for the next page.
Requires brevo:config:read. The connection also needs access to the relevant tables, objects, or workflows.
MCP action: list_brevo_activity. 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 |
|---|---|---|---|---|
kind |
query | No | "contact", "message" |
|
channel |
query | No | "email", "sms", "whatsapp" |
|
direction |
query | No | "to_brevo", "to_attio" |
|
status |
query | No | "synced", "skipped", "running", "failed", "unconfirmed", "outcome_unknown" |
|
started_by |
query | No | "person", "workflow", "automatic", "api", "not_recorded" |
|
cursor |
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 |
|---|---|---|---|
totals |
array of object | Yes | |
totals[].status |
"synced", "skipped", "running", "failed", "unconfirmed", "outcome_unknown" |
Yes | |
totals[].count |
integer | Yes | |
data |
array of object | Yes | |
data[].object |
"brevo_activity" |
Yes | |
data[].id |
string | Yes | |
data[].at |
string | Yes | |
data[].direction |
"to_brevo", "to_attio" |
Yes | |
data[].status |
"synced", "skipped", "running", "failed", "unconfirmed", "outcome_unknown" |
Yes | |
data[].kind |
"contact", "message" |
Yes | |
data[].record_id |
string or null | Yes | |
data[].channel |
"email", "sms", "whatsapp" or null |
Yes | |
data[].event |
string or null | Yes | |
data[].reason |
"excluded", "restricted", "identity_hold", "monitoring_not_current", "no_email", "no_contact", "changed", "confirming", "related_ambiguous", "not_verified", "recently_sent", "send_not_permitted", "template_no_sender", "not_delivered", "not_allowed", "workflow_off", "access_unchecked", "record_not_found", "not_completed", "attio_not_updated", "not_saved" or null |
Yes | |
data[].changed_attribute_ids |
array of string or null | Yes | |
data[].unmatched_attribute_ids |
array of string or null | Yes | |
data[].reconnect_attribute_ids |
array of string or null | Yes | |
data[].undo |
"available", "undone", "expired" or null |
Yes | |
data[].add_person |
"available", "adding", "unconfirmed" or null |
Yes | |
data[].list_id |
string or null | Yes | |
data[].template_id |
string or null | Yes | |
data[].started_by |
object or null | Yes | |
data[].started_by.kind |
"automatic", "person", "attio", "api_key", "assistant" |
Yes | When data[].started_by.kind is "automatic", "person", "attio", "api_key", "assistant". |
data[].started_by.name |
string or null | Yes | When data[].started_by.kind is "automatic", "person", "attio", "api_key", "assistant". |
data[].started_by.via |
"attio_change", "brevo_change", "brevo_message", "record_action", "bulk_action", "workflow" or null |
Yes | When data[].started_by.kind is "automatic", "person", "attio", "api_key", "assistant". |
data[].started_by.workspace_member_id |
string or null | Yes | When data[].started_by.kind is "automatic", "person", "attio", "api_key", "assistant". |
data[].started_by.workflow_id |
string or null | Yes | When data[].started_by.kind is "automatic", "person", "attio", "api_key", "assistant". |
pagination |
object | Yes | |
pagination.next_cursor |
string or null | 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 and safe retries before repeating a write.
Add the Person a Brevo Activity waits for
POST /v1/brevo-integration/activity/{activity_id}/person
Adds one Person to Attio for an email Activity waiting for its Person (a list_brevo_activity entry whose add_person is available or unconfirmed), with the email address and the first and last name Brevo has, whether or not message settings add People on their own. The Activities waiting for that address are then added to them. Nothing is sent to anyone. It is refused when a Person in Attio has or had the address, and needs workspace access that can create People. The Person is added shortly after; follow it with list_brevo_activity.
Requires brevo:execute. The connection also needs access to the relevant tables, objects, or workflows.
MCP action: create_brevo_activity_person. 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 |
|---|---|---|---|---|
activity_id |
path | Yes | string (uuid) | |
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_activity_person_add" |
Yes | |
data.activity_id |
string | Yes | |
data.accepted |
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.
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 and safe retries before repeating a write.
The public OpenAPI document 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 to inspect a real response with your connection's access.