Skip to main content
POST
/
send-button-list
curl --request POST \
  --url https://zapi.hubmessage.io/channels/{channel_id}/token/{channel_token}/send-button-list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "5511999999999",
  "message": "How would you rate our service?",
  "buttonList": {
    "buttons": [
      {
        "id": "1",
        "label": "Excellent"
      },
      {
        "id": "2",
        "label": "Good"
      },
      {
        "id": "3",
        "label": "Average"
      }
    ]
  }
}
'
{
  "zaapId": "3999984263738042930CD6ECDE9VDWSA",
  "messageId": "D241XXXX732339502B68",
  "id": "D241XXXX732339502B68"
}

​
Overview

Method for sending messages with quick selection buttons. The recipient can choose from the presented options, which work as a reply to the message. Optionally, you can include an image or video with the buttons by adding the image or video field inside buttonList.
Send only image or video, never both at the same time.
The response structure is identical to Z-API. Your existing code that processes these returns will continue working without changes.

Authorizations

​
Authorization
string
header
required

Secret Key generated in the Hub Message Security panel

Body

application/json
​
phone
string
required

Recipient phone number (country code + area code + number)

Example:

"5511999999999"

​
message
string
required

Message text (required, cannot be empty)

​
buttonList
object
required

Button configuration

​
delayMessage
integer

Delay in seconds before sending (1-15)

Required range: 1 <= x <= 15

Response

Message sent successfully

​
zaapId
string

Internal identifier

​
messageId
string

WhatsApp message ID

​
id
string

Same value as messageId (compatibility)