Skip to main content
POST
Send buttons or a list

Authorizations

Authorization
string
header
required

Your API key, e.g. gr_live_…

Headers

Idempotency-Key
string
required

Your own unique id for this request (at most 255 characters). The same id and body within 24 hours answers the first answer again — never a second send or charge.

Maximum string length: 255

Body

application/json
to
string
required

The person's WhatsApp number with its country code, e.g. +9198250*****.

body
string
required

The message text.

reference
string

Your own reference for this message (at most 512 characters). It comes back on the message and its webhooks.

Maximum string length: 512
buttons
object[]
Maximum array length: 3
list
object

A list instead of buttons.

Response

Accepted for sending.

id
string
status
string
to
string
country
string
category
string | null
price
string | null
reference
string | null