Scheduled Messages

Omdaa API allows you to schedule messages to be sent at a specific time in the future. You can schedule text messages, images, files, and interactive messages.

Schedule a Message

To schedule a message to be sent at a specific time:

"function">curl "keyword">-X POST https://omdaa.com/api/v1/scheduled \
  "keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN" \
  "keyword">-H "Content"keyword">-Type: application/json" \
  "keyword">-d '{
  "sessionId": "my"keyword">-instance",
  "to": "966501234567",
  "message": "Hello! This is a scheduled message",
  "scheduledAt": "2026-01-26T10:00:00Z"
}'

Required Parameters

ParameterTypeDescription
sessionIdstringSession identifier
tostringRecipient number
messagestringMessage text
scheduledAtstring (ISO 8601)Scheduled send time

Get Scheduled Messages

To get a list of all scheduled messages:

"function">curl "keyword">-X GET "https://omdaa.com/api/v1/scheduled?sessionId=my class="keyword">-instance" \
  "keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN"

Cancel Scheduled Message

To cancel a scheduled message before it's sent:

"function">curl "keyword">-X DELETE "https://omdaa.com/api/v1/scheduled/scheduled class="keyword">-message"keyword">-id" \
  "keyword">-H "Authorization: Bearer YOUR_JWT_TOKEN"

💡 Important Notes

  • Scheduled time must be in the future
  • Use ISO 8601 format for time (e.g., 2026-01-26T10:00:00Z)
  • You can cancel scheduled messages before they're sent
  • After sending, the message is automatically removed from scheduled list