API Reference

Send campaign

POST /campaigns/:id/send — send a draft now or schedule it.

POST/campaigns/:id/send

Sends a draft campaign. With no body it begins sending immediately (status → sending). Pass a future scheduled_at to schedule it (status → scheduled). The campaign must be a draft with a from, a subject, a body, and a verified from-domain.

Path parameters

idstringrequired

The campaign ID.

Body parameters

scheduled_atstringoptional

Optional. Schedule the send for later. Accepts an ISO 8601 timestamp (e.g. 2026-07-01T09:00:00Z) or natural language (e.g. in 1 min, in 1 hour). If in the future, the campaign is scheduled rather than sent now.

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.campaigns.send('8f5c2a1e-7b3d-4f9a-9c12-2e6d4a7b8c90', { "scheduled_at": "2026-07-01T09:00:00Z" });
console.log({ data, error });

Response

{
  "id": "8f5c2a1e-7b3d-4f9a-9c12-2e6d4a7b8c90"
}

Errors: not_found if the campaign is not yours; validation_error if it is already sending/scheduled/sent, is missing a from/subject/body, has an unverified from-domain, or scheduled_at is not a valid timestamp.