Campaigns

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.

post/campaigns/{campaignId}/schedule

Request

  • Base URL: https://app.lettr.com/api
  • URL: https://app.lettr.com/api/campaigns/{campaignId}/schedule
  • Auth: HTTP bearer

Path parameters

campaignIdstring uuid required

Campaign ID

Request body

scheduled_atstring 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 request

{
  "scheduled_at": "2026-06-01T09:00:00+00:00"
}

Response

Campaign scheduled for delivery.

messagestring required

Example response

{
  "message": "Campaign scheduled for delivery.",
  "data": {
    "id": "0193e6a8-1f3a-7c2a-b9e2-1aa1d2e5d3f0",
    "name": "Spring Sale",
    "status": "sent",
    "sent_count": 124,
    "created_at": "2026-05-01T09:00:00+00:00"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.