> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatsyncs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Interactive Buttons

> Send a WhatsApp session message with up to 3 reply buttons via the ChatSyncs API, optionally with an image/video/document header. Use when a developer asks how to send tappable reply buttons, or why a media+buttons request failed.

Sends a session message with up to 3 tappable **reply buttons**, optionally with an image,
video, or document attached as the header.

<Info>
  Like [Send Text Message](/developer-api/whatsapp/send-text-message), this is a **session
  message** — only deliverable within the 24-hour window after the recipient last messaged you.
</Info>


## OpenAPI

````yaml POST /whatsapp/send/interactive-buttons
openapi: 3.1.0
info:
  title: ChatSyncs Developer API
  version: 1.0.0
  description: >-
    REST API for sending WhatsApp messages and managing subscribers through
    ChatSyncs.
servers:
  - url: https://platform.chatsyncs.com/api/v1
security: []
paths:
  /whatsapp/send/interactive-buttons:
    post:
      tags:
        - WhatsApp API
      summary: Send Interactive Buttons
      operationId: sendInteractiveButtons
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                apiToken:
                  type: string
                  description: >-
                    Your ChatSyncs API key (not a WhatsApp/Meta access token).
                    [Where to find
                    it](/developer-api/finding-ids#api-token-apitoken).
                  example: API-KEY
                phone_number_id:
                  type: string
                  description: >-
                    The WhatsApp account's phone number ID. [Where to find
                    it](/developer-api/finding-ids#phone-number-id-phone_number_id).
                  example: PHONE-NUMBER-ID
                phone_number:
                  type: string
                  description: >-
                    The subscriber's phone number, with country code, digits
                    only.
                  example: PHONE-NUMBER
                message:
                  type: string
                  description: The message body shown above the buttons.
                  example: Choose an option
                buttons:
                  type: string
                  description: >-
                    JSON array of 1 to 3 reply buttons. Each item is a string or
                    an object with `id` and `title` (max 20 characters).
                  example: >-
                    [{"id":"buy_now","title":"Buy
                    Now"},{"id":"details","title":"View Details"}]
                button_header_text:
                  type: string
                  description: >-
                    Optional text header. Ignored if a media header is sent
                    instead.
                button_footer_text:
                  type: string
                  description: Optional footer text shown below the buttons.
                media_url:
                  type: string
                  description: >-
                    Public HTTPS URL of an image, video, or document to use as
                    the header. Use either media_url or media_id, not both.
                media_id:
                  type: string
                  description: >-
                    A WhatsApp media ID from [Upload
                    Media](/developer-api/whatsapp/upload-media). Requires
                    media_type when used.
                media_type:
                  type: string
                  description: >-
                    One of image, video, document. Required when using media_id,
                    or when media_url has no file extension. Audio is not
                    supported.
                media_name:
                  type: string
                  description: Filename to display — only used when media_type is document.
              required:
                - apiToken
                - phone_number_id
                - phone_number
                - message
                - buttons
      responses:
        '200':
          description: >-
            Standard ChatSyncs response. `status` is `"1"` on success and `"0"`
            on failure.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: '`"1"` = success, `"0"` = failure.'
                  message:
                    type: string
                    description: Human-readable result message.
              examples:
                success:
                  summary: Success
                  value:
                    status: '1'
                    wa_message_id: >-
                      wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=
                    message: Message sent successfully.
                error:
                  summary: Error
                  value:
                    status: '0'
                    message: Invalid request.

````