# Unsubscribes and blocks

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

Read retained subscription restrictions for the connected Brevo account.

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/).

## Request

```http
GET /v1/brevo-integration/unsubscribes

```

Lists the unsubscribes, spam complaints, hard bounces and Brevo blocks Neon Deer keeps for the Brevo account, latest first: the email address, the reason, whether it covers all marketing email or one list, when Neon Deer recorded it, and the Person in Attio the address is linked to now. Unsubscribes are managed in Brevo; nothing here sends email or resubscribes anyone. email finds one address exactly, in any letter case. reason narrows 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_unsubscribes`. 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 |
| -------- | ------- | -------- | ------------------------------------------------------------------- | ----- |
| `email`  | query   | No       | string                                                              |       |
| `reason` | query   | No       | `"unsubscribe"`, `"complaint"`, `"hard_bounce"`, `"provider_block"` |       |
| `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 |
| ------------------------ | -------------------------------------------------------------------------------- | ------------------ | ----- |
| `data`                   | array of object                                                                  | Yes                |       |
| `data[].object`          | `"brevo_unsubscribe"`                                                            | Yes                |       |
| `data[].id`              | string                                                                           | Yes                |       |
| `data[].email`           | string                                                                           | Yes                |       |
| `data[].reason`          | `"unsubscribe"`, `"complaint"`, `"hard_bounce"`, `"provider_block"`              | Yes                |       |
| `data[].scope`           | `"all_marketing_email"`, `"all_email"`, `"list"`, `"consent_group"`, `"unknown"` | Yes                |       |
| `data[].list_id`         | integer or null                                                                  | Yes                |       |
| `data[].list_name`       | string or null                                                                   | Yes                |       |
| `data[].recorded_at`     | string                                                                           | Yes                |       |
| `data[].record_id`       | string or null                                                                   | Yes                |       |
| `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](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.
