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

PreviousTemplatesNextAudiences & contacts