Broadcasts
Update broadcast
Update a draft broadcast. Send only the fields to change; it returns the updated broadcast.
PATCH
https://api.sndr.sh/v1/broadcasts/{id}Update broadcast
curl -X PATCH 'https://api.sndr.sh/v1/broadcasts/bca_9b3e6d12-a40' \
-H "Authorization: Bearer $SNDR_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"subject": "June product update: highlights"}'200OK
{
"id": "bca_9b3e6d12-a40",
"organization_id": "org_8d41c7a2-3f6",
"name": "June newsletter",
"group_id": "grp_4d8a0c5e-1f7",
"from_email": "hello@acme.com",
"subject": "June product update: highlights",
"html": "<h1>June update</h1><p>Here is what is new.</p>",
"status": "draft",
"total_recipients": 0,
"sent_count": 0,
"failed_count": 0,
"created_at": "2026-05-28T14:00:00Z"
}Authorization
AuthorizationstringheaderrequiredBearer followed by your API key. Needs the send scope.
Path parameters
idstringrequiredBroadcast ID (bca_...).
Body
application/jsonnamestringNew internal name, 1–120 characters.
group_idstringNew target group (grp_...).
from_emailstringNew sender, as an address or "Name <address>".
subjectstringNew subject line, 1–500 characters.
template_idstringNew template ID (tpl_...).
htmlstringNew HTML body.
textstringNew plain-text body.
Errors
401
unauthenticatedMissing or invalid API key.400
invalid_requestBody is not valid JSON, has an unknown field, or a field has the wrong type.400
not_editableThe broadcast is no longer a draft.403
insufficient_scopeThe API key is missing the send scope.404
not_foundResource does not exist or belongs to a different account.422
validation_failedname or subject is empty or too long, or from_email is invalid.