curl -X PATCH 'https://api.resend.com/broadcasts/id' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "example-name",
  "audience_id": "audience-id",
  "segment_id": "segment-id",
  "from": "Acme <onboarding@resend.dev>",
  "subject": "Hello World",
  "reply_to": [
    "example-reply-to"
  ],
  "preview_text": "example-preview-text",
  "html": "<p>It works!</p>",
  "text": "example-text",
  "topic_id": "topic-id"
}'

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

> Update an existing 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 PATCH 'https://api.resend.com/broadcasts/id' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0' \
  -H 'Content-Type: application/json' \
  -d '{"name":"example-name","audience_id":"audience-id"}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| id | path | string | Yes | The Broadcast ID. |
| name | body | string | No | Name of the broadcast. |
| audience_id | body | string | No | Use `segment_id` instead. Unique identifier of the audien... |
| segment_id | body | string | No | Unique identifier of the segment this broadcast will be s... |
Other params: from, subject, reply_to, preview_text, html, text, topic_id

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

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

PATCH

PATCH /broadcasts/{id} — Resend API

Resend API

Update an existing 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
→ 227 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 PATCH 'https://api.resend.com/broadcasts/id' \  -H "Authorization: Bearer $RESEND_API_KEY" \  -H 'User-Agent: my-app/1.0' \  -H 'Content-Type: application/json' \  -d '{  "name": "example-name",  "audience_id": "audience-id",  "segment_id": "segment-id",  "from": "Acme <[email protected]>",  "subject": "Hello World",  "reply_to": [    "example-reply-to"  ],  "preview_text": "example-preview-text",  "html": "<p>It works!</p>",  "text": "example-text",  "topic_id": "topic-id"}'

Parameters

Name	In	Type	Required	Description
id	path	string	Yes	The Broadcast ID.
name	body	string	No	Name of the broadcast.
audience_id	body	string	No	Use `segment_id` instead. Unique identifier of the audience this broadcast will be sent to.
segment_id	body	string	No	Unique identifier of the segment this broadcast will be sent to.
from	body	string	No	The email address of the sender.
subject	body	string	No	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.

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.