Skip to main content
One request to Create Message can send to up to 100 recipients. AhaSend creates a separate message for each recipient: every person gets their own email, sees only their own address, and can get their own content through substitutions. Available on Free, Pro and Max. See plans and features.

How do I send one request to many recipients?

List the recipients in recipients. Values in a recipient’s substitutions override the request’s own substitutions, so you can set a default once and personalize per person.
recipients doesn’t put several addresses in one To header. Each recipient gets a separate message. To send one message to several people who see each other, use CC and BCC.

How do I check which recipients were sent?

The response holds one item per recipient, in the order of your request. A request can succeed as a whole (HTTP 202) while the message for one recipient is not sent. Check every item:
An invalid recipient address doesn’t show up here: it fails the whole request with 400, and nothing is sent. Keep each id to look the message up later with Get Message, and use webhooks to learn whether each one was delivered. A recipient on your suppression list is accepted here and reported later as suppressed; see why an email was suppressed.

How do I send to more than 100 recipients?

Split the list into requests of up to 100 recipients and send them one after another or in parallel, within the API rate limit of 100 requests per second. Give every request its own idempotency key, so a retry after a timeout never sends a batch twice. The number of emails your account can send per hour is a separate limit; see sending limits.
For newsletters and other marketing mail to a list, Campaign Builder does the batching, unsubscribe handling and reporting for you, and sends over the marketing infrastructure.

How do I send one message with CC or BCC?

Use Create Conversation Message. It sends one message with to, cc and bcc, up to 50 addresses combined, the way a person sends an email from their mail client.
Conversation messages don’t support substitutions; use Create Message when the content differs per recipient.