Messages
A message is a single notification to a single recipient on one channel.
POST/v2/messages
Creates and queues a message.
| Field | Type | Description |
|---|---|---|
channel | string | email, sms or push |
to | string | Address, phone number in E.164 or device token |
template | string | Template slug, for example order_shipped |
data | object | Variables substituted into the template |
send_at | string | Optional ISO 8601 time for scheduled delivery |
GET/v2/messages/{id}
Returns the message and its current status: queued, sent, delivered, bounced or failed.
{
"id": "msg_9fK2c1Zx",
"status": "delivered",
"channel": "email",
"delivered_at": "2026-10-31T09:14:29Z",
"attempts": 1
}GET/v2/messages
Lists messages, newest first. Supports status, channel, created_after and cursor pagination with limit (default 25, maximum 100).
DELETE/v2/messages/{id}
Cancels a scheduled message that has not been sent yet. Returns 409 if sending already started.