Skip to main content
POST
/
messages
Send a message to a contact using a template
curl --request POST \
  --url https://api.example.com/messages \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "customerId": "550e8400-e29b-41d4-a716-446655440000",
  "contactId": "7c11e821-c839-4c3d-8a89-1f78b71a0c38",
  "templateId": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"
}
'
{
  "messageId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "queued",
  "channel": "whatsapp"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json

Message details including customer ID, contact ID, and template ID

Request model for sending a message to a contact using a template

​
customerId
string<uuid>
required

Unique identifier of the customer

​
contactId
string<uuid>
required

Unique identifier of the contact

​
templateId
string<uuid>
required

Unique identifier of the message template

Response

Message successfully queued for delivery

​
messageId
string<uuid>

Unique identifier for tracking the message

​
status
enum<string>

Current status of the message

Available options:
queued,
sending,
delivered
​
channel
enum<string>

Selected delivery channel

Available options:
sms,
whatsapp