Sign in
WhatsApp

Send a WhatsApp message

Sends a WhatsApp template message from a registered sender to a recipient.

post/v1/whatsapp/messages

Request body

fromstring required

Sender's phone number, 6-20 digits.

tostring required

Recipient's phone number, 6-20 digits.

Example request

{
  "from": "14155550100",
  "to": "447537151866",
  "template": {
    "name": "order_shipped",
    "language": "en_US",
    "placeholders": [
      "123456"
    ],
    "header": {
      "type": "TEXT"
    },
    "buttons": [
      {
        "type": "QUICK_REPLY"
      }
    ]
  }
}

Response

The submitted message, with its uuid and initial status.

Example response

{
  "message": {
    "uuid": "3a525ca2-6909-4c72-9399-905adf7f3a74",
    "from": "14155550100",
    "to": "447537151866",
    "status": "sent",
    "template": {
      "name": "order_shipped",
      "language": "en_US"
    },
    "created_at": "2026-01-15T10:30:00Z"
  }
}

Changes

Changed in 1 of the 55 revisions of this API.1