Skip to main content
POST
Schedule a campaign
Schedules a campaign for future delivery, or reschedules an already-scheduled campaign to a new time. The campaign transitions to (or stays) scheduled and is dispatched automatically at the given time. Requires the campaigns:write scope. Not available to sandbox keys.

Authorizations

Authorization
string
header
required

API key for authentication

Path Parameters

campaignId
string<uuid>
required

Campaign ID

Body

application/json
scheduled_at
string<date-time>
required

Future delivery time (ISO 8601). Include a timezone offset (e.g. +02:00 or Z); a value without an offset is interpreted as UTC. Must be in the future.

Example:

"2026-06-01T09:00:00+00:00"

Response

Campaign scheduled for delivery.

message
string
required
Example:

"Campaign scheduled for delivery."

data
object

The updated campaign. Present on success; omitted in the rare case the campaign cannot be re-read immediately after the action (e.g. it was concurrently deleted).