Add Recipients
Mailing Lists
Add Recipients
Bulk-add email addresses to a mailing list
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
API tokens are created in the Dashboard under API Keys. The list must belong to the token’s project.
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 theAuthorization header.
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