Skip to main content
POST
/
v1
/
broadcasts
Create Broadcast
curl --request POST \
  --url https://api.unosend.co/v1/broadcasts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "subject": "<string>",
  "from_email": "<string>",
  "from_name": "<string>",
  "audience_id": "<string>",
  "html_content": "<string>",
  "text_content": "<string>",
  "scheduled_at": "<string>"
}
'
​
name
string
required
Name of the broadcast for internal reference.
​
subject
string
required
Email subject line for the broadcast.
​
from_email
string
required
Sender email address. Must be from a verified domain.
​
from_name
string
Sender display name.
​
audience_id
string
required
UUID of the target audience.
​
html_content
string
required
HTML content of the broadcast. Supports template variables: {{first_name}}, {{last_name}}, {{email}}, {{unsubscribe_url}}.
​
text_content
string
Plain text version of the broadcast.
​
scheduled_at
string
ISO 8601 datetime for scheduled sending. Omit to save as draft.