Skip to main content
POST
/
scheduled-messages
Create scheduled message
curl --request POST \
  --url https://api-message.nativehub.live/api/v1/scheduled-messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "+8801912345678",
  "to": "+8801712345678",
  "body": "Reminder: Your appointment is tomorrow at 3 PM.",
  "scheduled_at": "2026-02-15T09:00:00Z"
}
'
{
  "id": "a3b4c5d6-e7f8-9012-ab34-567890123456",
  "tenant_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "account_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "from_number": "+8801912345678",
  "to_number": "+8801712345678",
  "body": "Reminder: Your appointment is tomorrow at 3 PM.",
  "status": "pending",
  "scheduled_at": "2026-02-15T09:00:00Z",
  "created_at": "2026-02-14T14:00:00Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
from
string
required
​
to
string
required
​
body
string
required
​
scheduled_at
string<date-time>
required

Response

Message scheduled successfully

​
id
string<uuid>
​
tenant_id
string<uuid>
​
account_id
string<uuid>
​
from_number
string
​
to_number
string
​
body
string
​
status
string
​
scheduled_at
string<date-time>
​
message_id
string<uuid>
​
created_at
string<date-time>