Sequences

Add emails to the unsubscribe list

Changed on

Adds email addresses to the workspace's sequence unsubscribe list. Email addresses on the unsubscribe list cannot be enrolled in any sequence, and any of their active sequence runs are exited. Email addresses that are already on the unsubscribe list are ignored, so this endpoint is safe to retry.

This endpoint is in beta. We will aim to avoid breaking changes, but small updates may be made as we roll out to more users.

Required scopes: sequence_unsubscribe:read-write.

Supported token levels: workspace, user.

post/v2/sequences/unsubscribed_emails

Request

  • Base URL
    https://api.attio.com
  • URL
    https://api.attio.com/v2/sequences/unsubscribed_emails
  • Auth
    OAuth 2
    Authorization code: https://app.attio.com/authorize
    Token URL: https://app.attio.com/oauth/token scopes: sequence_unsubscribe:read-write

Request body

Example request

{
  "data": {
    "email_addresses": [
      "person@example.com"
    ]
  }
}

Response

Success

Example response

{
  "data": [
    {
      "email_address": "person@example.com",
      "created_at": "2026-01-02T15:04:05.000Z"
    }
  ]
}

Changes