> ## Documentation Index
> Fetch the complete documentation index at: https://ahasend.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> AhaSend stores all message data in the EU. See /facts.
> The API base URL is https://api.ahasend.com. Send the API key in the Authorization: Bearer header. See /api-reference/authentication.
> Use send.ahasend.com for SMTP. Ports 25, 587 and 2525 use STARTTLS. Port 465 is not supported. See /smtp.
> For send-only integrations, create an API Key v2 under Credentials → Add and scope it to messages:send:{your-domain}. See /send-api/credentials and /api-reference/scopes.

# Send to Multiple Recipients

> Send personalized email to up to 100 recipients per API request, with per-recipient substitutions, partial failures handled per message, and CC or BCC.

One request to [Create Message](https://ahasend.com/docs/api-reference/messages/create-message.md) 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](https://ahasend.com/docs/facts.md#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.

```bash theme={null}
curl --request POST \
  --url https://api.ahasend.com/v2/accounts/{account_id}/messages \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: order-batch-2026-11-11-0001' \
  --data '{
    "sandbox": true,
    "from": { "email": "orders@yourdomain.com", "name": "Your Store" },
    "recipients": [
      { "email": "anna@example.com", "name": "Anna", "substitutions": { "first_name": "Anna", "order_id": "1001" } },
      { "email": "ben@example.com", "name": "Ben", "substitutions": { "first_name": "Ben", "order_id": "1002" } }
    ],
    "subject": "Order {{ order_id }} is on its way",
    "html_content": "<p>Hi {{ first_name }}, order {{ order_id }} has shipped.</p>",
    "text_content": "Hi {{ first_name }}, order {{ order_id }} has shipped.",
    "substitutions": { "first_name": "there" }
  }'
```

> [!NOTE]
>
> `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](#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:

```json theme={null}
{
  "object": "list",
  "data": [
    { "object": "message", "id": "3f8e2b1a-7c4d-4e2a-9b1e-2f3a4b5c6d7e", "recipient": { "email": "anna@example.com", "name": "Anna" }, "status": "queued", "error": null },
    { "object": "message", "id": null, "recipient": { "email": "ben@example.com", "name": "Ben" }, "status": "error", "error": "<why this message was not sent>" }
  ]
}
```

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](https://ahasend.com/docs/api-reference/messages/get-message.md), and use [webhooks](https://ahasend.com/docs/integrations/webhooks.md) 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](https://ahasend.com/docs/bounces.md#why-was-my-email-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](https://ahasend.com/docs/api-reference/rate-limits.md) of 100 requests per second. Give every request its own [idempotency key](https://ahasend.com/docs/api-reference/idempotency.md), 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](https://ahasend.com/docs/api-reference/rate-limits.md#sending-limits).

> [!TIP]
>
> For newsletters and other marketing mail to a list, [Campaign Builder](https://ahasend.com/docs/campaigns.md) 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](https://ahasend.com/docs/api-reference/messages/create-conversation.md). 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.

```json theme={null}
{
  "from": { "email": "support@yourdomain.com", "name": "Support" },
  "to": [{ "email": "customer@example.com" }],
  "cc": [{ "email": "account-manager@yourdomain.com" }],
  "bcc": [{ "email": "archive@yourdomain.com" }],
  "subject": "Your support request",
  "text_content": "Thanks for getting in touch. We're on it."
}
```

Conversation messages don't support substitutions; use Create Message when the content differs per recipient.

## Related guides

* [Send email](https://ahasend.com/docs/send-api/send-email.md), [Transactional templates](https://ahasend.com/docs/send-api/templates.md), [Idempotency](https://ahasend.com/docs/api-reference/idempotency.md).
* [Rate limits](https://ahasend.com/docs/api-reference/rate-limits.md), [Webhooks](https://ahasend.com/docs/integrations/webhooks.md), [Sandbox mode](https://ahasend.com/docs/send-api/sandbox.md).
* [Bounces and suppressions](https://ahasend.com/docs/bounces.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.