1. Scheduling
Nabd Messaging
  • WhatsApp
    • Send a text message (WhatsApp)
      POST
    • Send an image or document (WhatsApp)
      POST
    • Send a saved template (WhatsApp)
      POST
    • Check whether a phone number is on WhatsApp
      POST
    • Resolve a WhatsApp identity (phone, WhatsApp ID, or username)
      POST
    • List WhatsApp chats
      POST
    • List WhatsApp groups
      POST
    • Read the WhatsApp device status
      POST
  • Telegram
    • Send a text message (Telegram)
      POST
    • Send an image or document (Telegram)
      POST
    • Send a saved template (Telegram)
      POST
    • List Telegram chats and dialogs
      POST
    • List Telegram groups and channels
      POST
    • Read the Telegram account status
      POST
  • Templates
    • List templates
      POST
    • Get a template
      POST
  • Messages
    • List sent messages
      POST
    • Get a sent message
      POST
  • Phonebook
    • List contacts
      POST
    • Create a contact
      POST
    • Update a contact
      POST
    • Delete a contact
      POST
    • List contact groups
      POST
    • Create a contact group
      POST
    • Delete a contact group
      POST
    • Add contacts to a group
      POST
    • Remove contacts from a group
      POST
  • Scheduling
    • Schedule a message
      POST
    • List scheduled messages
      POST
    • Cancel a scheduled message
      POST
  • Account
    • Read account usage and limits
  • Schemas
    • AuthKeys
    • AuthKeyOnlyRequest
    • AuthAppRequest
    • WhatsAppSendTextRequest
    • ContactsResponse
    • WhatsAppSendMediaRequest
    • SendTemplateRequest
    • GroupsResponse
    • TelegramSendTextRequest
    • TelegramSendMediaRequest
    • ResolveResponse
    • NumberCheckRequest
    • LookupRequest
    • ValidationError
    • ChatsRequest
    • UsernameError
    • TemplatesListRequest
    • WaServerError
    • TemplatesGetRequest
    • WaDeviceNotConnected
    • MessagesListRequest
    • MessagesGetRequest
    • ResolveRateLimit
    • ContactsListRequest
    • ContactsCreateRequest
    • RateLimitAny
    • ContactsUpdateRequest
    • ReqIdRequest
    • ReqGroupIdRequest
    • ReqScheduleIdRequest
    • ContactGroupsCreateRequest
    • AddRemoveContactsRequest
    • ScheduleCreateRequest
    • ScheduleListRequest
    • Envelope
    • PaginatedEnvelope
    • Error
    • RateLimitExceededSchema
    • LookupResponse
    • ChatsResponse
    • GroupsChatsResponse
    • TelegramDialogsResponse
    • ContactItem
    • AuthRequest
    • ContactsRequest
    • CreateMessageRequest
    • CreateMessageResponse
    • ResolveRequest
    • AuthError
    • RateLimitExceeded
    • SendBlocked
  1. Scheduling

Schedule a message

POST
/api/schedule/create
Last modified:2026-09-29 09:27:11
Schedule a WhatsApp or Telegram message to be sent later.
Use it to send at the customer's convenient time, or during your quiet
hours, without holding a worker open.
schedule_at: required, format Y-m-d H:i (e.g. 2026-10-01 14:30),
interpreted in timezone. Must be in the future and no more than 365
days ahead
.
timezone: optional, an IANA timezone (defaults to the server timezone).
Recipients: provide exactly one of to or group_id.
to: a single recipient (WhatsApp phone / WhatsApp ID / username;
Telegram user ID / @username). A to that is not in the phonebook
is saved as a contact and counts toward the plan's contact limit.
group_id: schedule to all members of a contact group that have an
address for the channel; a group with no such contacts is 422.
Content: message (plain text, max 1000) or a file URL (media), or
template_id (+ optional variables). template_id cannot be combined
with message or file.
The returned schedule_id is used by schedule/list and
schedule/cancel.

Request

Body Params application/jsonRequired

Examples

Responses

🟢201
application/json
Message scheduled.
Bodyapplication/json

🟠403
🟠404
🟠401Error401
🟠422Error422
🟠429Error429
🔴500Error500ServerError
Request Request Example
Shell
JavaScript
Java
Swift
cURL
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"
}'
Response Response Example
201 - success
{
    "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
    }
}
Modified at 2026-09-29 09:27:11
Previous
Remove contacts from a group
Next
List scheduled messages
Built with