schedule_at: required, format Y-m-d H:i (e.g. 2026-10-01 14:30),timezone. Must be in the future and no more than 365timezone: optional, an IANA timezone (defaults to the server timezone).to or group_id.to: a single recipient (WhatsApp phone / WhatsApp ID / username;@username). A to that is not in the phonebookgroup_id: schedule to all members of a contact group that have an422.message (plain text, max 1000) or a file URL (media), ortemplate_id (+ optional variables). template_id cannot be combinedmessage or file.schedule_id is used by schedule/list andschedule/cancel.curl --location '/api/schedule/create' \
--header 'Content-Type: application/json' \
--data '{
"authkey": "{{authkey}}",
"appkey": "{{appkey}}",
"schedule_at": "2026-10-01 14:30",
"timezone": "Asia/Riyadh",
"to": "966501234567",
"message": "Reminder for tomorrow"
}'{
"success": true,
"data": {
"schedule_id": 12,
"channel": "whatsapp",
"status": "pending",
"schedule_at": "2026-10-01T14:30:00+03:00",
"timezone": "Asia/Riyadh",
"recipients_count": 1
}
}