> ## Documentation Index
> Fetch the complete documentation index at: https://developer.z-api.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Reply to button list

> Replies to a button list option as if the user had clicked it

## Concept

This endpoint allows you to reply to a button list option, simulating a user click on one of the options previously sent via [send-button-list](/message/send-button-list).

<Info>
  The button must have been previously sent and the **button ID** must be obtained via the message received webhook.
</Info>

#### Example on WhatsApp

<div style={{ display: "flex", justifyContent: "center" }}>
  <img src="https://mintcdn.com/z-api-8aa3bb40/c1Sn38QJwMBwsVRm/images/reply-button-eng.jpeg?fit=max&auto=format&n=c1Sn38QJwMBwsVRm&q=85&s=cfb8b912c36d1cb09aec4d3c5222d42e" width="400" data-path="images/reply-button-eng.jpeg" />
</div>

***

## Attributes

<ParamField path="instanceId" type="string" required>
  Your instance ID. Available in the Z-API panel under **Instances**.
</ParamField>

<ParamField path="token" type="string" required>
  Your Z-API instance token.
</ParamField>

### Required

<ParamField body="phone" type="string" required>
  Phone number (or group ID) in the format COUNTRY CODE + AREA CODE + NUMBER. Example: 551199999999
</ParamField>

<ParamField body="responseButtonId" type="string" required>
  Selected button ID. This ID is obtained via the message received webhook.
</ParamField>

<ParamField body="messageId" type="string" required>
  ID of the message that contains the previously sent buttons.
</ParamField>

***

## Request Body

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "phone": "5511999999999",
  "responseButtonId": "1",
  "messageId": "D241XXXX732339502B68"
}
```

## Response

### 200

<ResponseField name="zaapId" type="string">
  Message ID in Z-API
</ResponseField>

<ResponseField name="messageId" type="string">
  Message ID in WhatsApp
</ResponseField>

<ResponseField name="id" type="string">
  Added for Zapier compatibility, it has the same value as messageId
</ResponseField>

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "zaapId": "3999984263738042930CD6ECDE9VDWSA",
  "messageId": "D241XXXX732339502B68",
  "id": "D241XXXX732339502B68"
}
```

### 405

Make sure you are using the correct HTTP method (POST).

### 415

Make sure to include the Content-Type: application/json header.