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": "example-name",
  "segment_id": "segment-id",
  "audience_id": "audience-id",
  "from": "Acme <onboarding@resend.dev>",
  "subject": "Hello World",
  "reply_to": [
    "example-reply-to"
  ],
  "preview_text": "Here are our announcements",
  "html": "<p>It works!</p>",
  "text": "example-text",
  "topic_id": "topic-id",
  "send": true,
  "scheduled_at": "example-scheduled-at"
}'

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

> 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.

## 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 '{"segment_id":"segment-id","from":"Acme <onboarding@resend.dev>","subject":"Hello World"}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| segment_id | body | string | Yes | Unique identifier of the segment this broadcast will be s... |
| from | body | string | Yes | The email address of the sender. |
| subject | body | string | Yes | The subject line of the email. |
| name | body | string | No | Name of the broadcast. |
Other params: audience_id, reply_to, preview_text, html, text, topic_id, send, scheduled_at

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

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

POST

POST /broadcasts — Resend API

Resend API

Create a broadcast

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

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 231 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.

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": "example-name",  "segment_id": "segment-id",  "audience_id": "audience-id",  "from": "Acme <[email protected]>",  "subject": "Hello World",  "reply_to": [    "example-reply-to"  ],  "preview_text": "Here are our announcements",  "html": "<p>It works!</p>",  "text": "example-text",  "topic_id": "topic-id",  "send": true,  "scheduled_at": "example-scheduled-at"}'

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"
}

Get a free Resend API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.