Create and Send Broadcasts via API

Use the Broadcast API to create and send a broadcast with a single request.

Previously, creating and sending a Broadcast required two separate API requests. Now you can do it in one by setting send: true.

import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.broadcasts.create({
  segmentId: '78261eea-8f8b-4381-83c6-79fa7120f1cf',
  from: 'Acme <onboarding@resend.dev>',
  subject: 'hello world',
  html: 'Hi {{{FIRST_NAME|there}}}',
  send: true,
});

Send and Schedule

You can also schedule the broadcast in the same call using natural language or ISO 8601:

  send: true,
  scheduledAt: 'in 1 hour',