Schedule a broadcast to send at a future time

Authorization

api-key

X-API-Key<token>

In: header

Path Parameters

id*string

Broadcast UUID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

scheduledAt*string

UTC send time (used when timezoneMode is fixed)

timezoneMode?string

Default"fixed"

Value in

"fixed"
"subscriber"

localTime?string

Local time for contact-timezone sends (HH:mm)

localDate?string

Local date for contact-timezone sends (YYYY-MM-DD)

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/broadcasts/string/schedule" \  -H "Content-Type: application/json" \  -d '{    "scheduledAt": "2026-06-01T10:00:00Z"  }'

{  "id": "550e8400-e29b-41d4-a716-446655440000",  "workspaceId": "550e8400-e29b-41d4-a716-446655440000",  "name": "Summer Sale Announcement",  "status": "scheduled",  "subject": "Our biggest sale of the year 🎉",  "previewText": "Preview of what's inside...",  "fromName": "Peleka Team",  "fromEmail": "[email protected]",  "audienceType": "all",  "audienceFilter": {    "ids": []  },  "blocks": [],  "theme": "modern",  "footerStyles": {},  "sentCount": 0,  "createdAt": "2026-01-01T00:00:00.000Z",  "updatedAt": "2026-01-01T00:00:00.000Z",  "scheduledAt": "2026-06-01T10:00:00.000Z"}