Skip to main content
POST
Add Recipients
Bulk-adds email addresses to a mailing list — for example, syncing signups from your own database. Send up to 1000 addresses per request. Each address is validated individually; invalid entries are reported in the invalid array rather than failing the batch. Addresses are deduplicated case-insensitively, and addresses already on the list — including unsubscribed ones — are counted in skipped_existing, so re-syncing never resurrects an opt-out. A list holds at most 500 active recipients.

Authentication

This endpoint requires an API token passed as a Bearer token in the Authorization header.
API tokens are created in the Dashboard under API Keys. The list must belong to the token’s project.

Path Parameters

string
required
The mailing list’s unique identifier (UUID). List ids come from List Mailing Lists.

Body

string[]
required
Email addresses to add. Between 1 and 1000 items per request.

Request

Response

integer
required
Number of addresses added to the list
integer
required
Number of addresses already on the list (including unsubscribed ones, which are never re-activated)
string[]
required
Addresses that failed validation and were not added

Example Response

200

Errors

Rate Limits

This endpoint is limited to 30 requests per minute per IP.