---
title: "Add emails to the unsubscribe list"
method: POST
path: "/v2/sequences/unsubscribed_emails"
tags: ["Sequences"]
---

# Add emails to the unsubscribe list

`POST /v2/sequences/unsubscribed_emails`

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`.

## Request body

- object
  - `data` object, required
    - `email_addresses` string[], required — The email addresses to add to the unsubscribe list. A maximum of 1000 email addresses can be provided per request. Email addresses are normalized before they are stored.

## Response `200`

Success

- object — Success
  - `data` object[], required
    - `email_address` string, required — The normalized email address on the unsubscribe list.
    - `created_at` string, date-time, required — When the email address was added to the unsubscribe list.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/attio/apis/attio-api.md) · [All operations](https://skmtc.net/attio/apis/attio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attio/attio-api/revisions/6ad6c02e6af9/schema)