Skip to main content
POST
Send Email
Send an HTML email to one or multiple recipients. Delivery is asynchronous: a successful request returns 202 Accepted with a batchId, and the emails are processed in the background. Maximum 500 recipients per API call. Unsubscribed recipients are filtered out automatically before sending and do not count toward your sending limit.

Request

The body has two parts:
  • recipients — array of { email, name? } (1–500 items, email required).
  • emailConfig — message configuration.
Required emailConfig fields: subject, from, body (HTML). Optional emailConfig fields:

Response

  • 202 Accepted: Processing started. Returns status: "IN PROGRESS", message, batchId, and a limits object.
  • 400 Bad Request: Invalid request parameters or malformed JSON
  • 401 Unauthorized: Authentication required or invalid API key
  • 500 Internal Server Error: Unexpected server error
The response limits object shows your sending-quota usage for this request (limit, used, remaining, requested). requested reflects the recipient count after unsubscribed addresses are filtered out.
Authenticate with your API key in the Authorization header. The key must have the emailSend scope.

Authorizations

Authorization
string
header
required

Body

application/json

Email configuration and recipients. Maximum 500 recipients per API call. Unsubscribed recipients are filtered out automatically and do not count toward your sending limit.

recipients
object[]
required

List of email recipients. Maximum 500 per call.

emailConfig
object
required

Response

Accepted — email processing has started. Delivery happens asynchronously.

status
enum<string>

Processing status

Available options:
IN PROGRESS
message
string

Status message, e.g. "Email processing started"

batchId
string

Identifier for this send batch (e.g. batch_1782700000000_ab12cd34)

limits
object

Your sending-limit usage for this request