Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

App API key (format: sk_live_app_* or sk_test_app_*) for app-level operations

Body

application/json
from
string
required

Your WhatsApp phone number to send from (E.164 format)

Pattern: ^\+[1-9]\d{1,14}$
Example:

"+15551234567"

to
string
required

Recipient phone number in E.164 format

Pattern: ^\+[1-9]\d{1,14}$
Example:

"+15559876543"

templateName
string
required

Name of the approved template to send

Example:

"order_confirmation"

languageCode
string
required

Language code of the template

Example:

"en_US"

variables
object

Body variables as key-value pairs

Example:
headerVariables
object

Header variables as key-value pairs

Example:
buttonVariables
object

Button URL variables by button index (e.g., button_0: ['value'])

Example:

Response

Message sent successfully

id
string
required

Chirp message ID - use this to correlate with webhook events

Example:

"msg_wa_abc123"

messaging_product
enum<string>
required
Available options:
whatsapp
contacts
object[]
required
messages
object[]
required