DocsBroadcasts ▾
IntroductionQuickstartAuthenticationSending emailDomainsAPI keysSMTP relayWebhooksTemplatesBroadcastsAudiences & contactsSuppression listOpen & click trackingIP warm-upDeliverabilityAnalytics & logsLimits & errorsSelf-hosting & configurationEmailsDomainsAudiences & contactsBroadcastsTemplatesWebhooksAPI keys, suppressions, metrics
Guides
Broadcasts
Broadcasts send one message to every subscribed contact in an audience. Create a draft, then send immediately or schedule.
curl -X POST 'https://api.mailvina.com/broadcasts' \
-H 'Authorization: Bearer mv_xxxxxxxxx' \
-H 'Content-Type: application/json' \
-d '{
"name": "November update",
"audience_id": "AUDIENCE_ID",
"from": "Acme <[email protected]>",
"subject": "What is new, {{{FIRST_NAME|friend}}}",
"html": "<p>Big news…</p>"
}'curl -X POST 'https://api.mailvina.com/broadcasts/:id/send' \
-H 'Authorization: Bearer mv_xxxxxxxxx' \
-H 'Content-Type: application/json' \
-d '{
"scheduled_at": "2026-12-01T09:00:00Z"
}'Variables
{{{FIRST_NAME}}}, {{{LAST_NAME}}}, {{{EMAIL}}} and {{{MAILVINA_UNSUBSCRIBE_URL}}}. If you omit the unsubscribe URL we append a footer link for you. Every broadcast email also carries List-Unsubscribe and List-Unsubscribe-Post headers.
Unsubscribed contacts and suppressed addresses are skipped automatically.