Emails
Send multiple emails
Send up to 100 emails in a single request. Useful for sending personalized emails to multiple recipients efficiently.
Each email in the batch can have different content and recipients. Failed emails don't affect other emails in the batch.
Idempotency: Supports Idempotency-Key header for safe retries.
post/emails/batch
Headers
Idempotency-Keystring
Unique key for idempotent requests. If a request with this key was already processed, the cached response is returned. Keys expire after 24 hours.
Request body
Example request
{
"emails": [
{
"metadata": {
"user_id": "usr_123456",
"order_id": "ord_789012",
"campaign": "welcome_series"
}
}
]
}Response
Batch accepted
Example response
{
"data": {
"total": 10,
"accepted": 9,
"failed": 1
},
"meta": {
"requestId": "req_V1StGXR8_Z5jdHi6"
}
}