curl -X POST 'https://api.resend.com/broadcasts' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string",
  "segment_id": "string",
  "audience_id": "string",
  "from": "string",
  "subject": "string",
  "reply_to": [
    "string"
  ],
  "preview_text": "Here are our announcements",
  "html": "string",
  "text": "string",
  "topic_id": "string",
  "send": true,
  "scheduled_at": "string"
}'

# POST /broadcasts (Resend API)
Base URL: https://api.resend.com
Auth: Authorization: Bearer <RESEND_API_KEY>
Last verified: 2026-09-03

> Create a broadcast

## Critical Gotchas
* All requests must include a `User-Agent` header (e.g. `User-Agent: my-app/1.0`) or the API returns HTTP 403.
* The `to` field is an array of strings, even when sending to a single recipient.

## cURL
curl -X POST 'https://api.resend.com/broadcasts' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0' \
  -H 'Content-Type: application/json' \
  -d '{"name":"string","segment_id":"string"}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| segment_id | body | string | Yes | Unique identifier of the segment this... |
| from | body | string | Yes | The email address of the sender. |
| subject | body | string | Yes | The subject line of the email. |

## Response (200 OK)
{"id":"78261eea-8f8b-4381-83c6-79fa7120f1cf","object":"broadcast"}

---
Need an API key? Get one at https://resend.com/signup

POST

/broadcasts

Resend API

Create a broadcast

Base URL: https://api.resend.com
Auth: Authorization: Bearer <RESEND_API_KEY>
Last verified: 2026-09-03 · upstream hash matched

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 212 tokens · Vary: Accept

Critical gotchas

All requests must include a User-Agent header (e.g. User-Agent: my-app/1.0) or the API returns HTTP 403.

The to field is an array of strings, even when sending to a single recipient.

cURL

curl -X POST 'https://api.resend.com/broadcasts' \  -H "Authorization: Bearer $RESEND_API_KEY" \  -H 'User-Agent: my-app/1.0' \  -H 'Content-Type: application/json' \  -d '{  "name": "string",  "segment_id": "string",  "audience_id": "string",  "from": "string",  "subject": "string",  "reply_to": [    "string"  ],  "preview_text": "Here are our announcements",  "html": "string",  "text": "string",  "topic_id": "string",  "send": true,  "scheduled_at": "string"}'

Get a free Resend API key → sponsored

Parameters

Name	In	Type	Required	Description
name	body	string	No	Name of the broadcast.
segment_id	body	string	Yes	Unique identifier of the segment this broadcast will be sent to.
audience_id	body	string	No	Use `segment_id` instead. Unique identifier of the segment this broadcast will be sent to.
from	body	string	Yes	The email address of the sender.
subject	body	string	Yes	The subject line of the email.
reply_to	body	string[]	No	The email addresses to which replies should be sent.
preview_text	body	string	No	The preview text of the email.
html	body	string	No	The HTML version of the message.
text	body	string	No	The plain text version of the message.
topic_id	body	string	No	The topic ID that the broadcast will be scoped to.
send	body	boolean	No	Whether to send the broadcast immediately or keep it as a draft.
scheduled_at	body	string	No	Schedule time to send the broadcast. Can only be used if `send` is true.

Response 200 OK

{
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "object": "broadcast"
}