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

# Get Post Back List

> List all postbacks (quick replies / button actions) configured on a WhatsApp bot via the ChatSyncs API. Use when a developer asks how to look up postback IDs programmatically, e.g. to use with Outbound Actions triggers.

Lists every postback configured on a WhatsApp bot — the same postbacks you'd see when setting
a [Postback trigger on an Outbound Action](https://help.chatsyncs.com/docs/bot-flow-external-api).

## Example Request

```bash theme={null}
curl --request GET \
  --url 'https://platform.chatsyncs.com/api/v1/whatsapp/get/post-back-list?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID'
```

Each row describes one postback: its `postback_id` and `bot_name`, plus the settings attached to it. The rows are long;
most of the columns are internal settings.


## OpenAPI

````yaml GET /whatsapp/get/post-back-list
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.


    **Authentication.** Send your key as the `apiToken` parameter, or as
    `Authorization: Bearer <key>` — both work on every endpoint **except Custom
    Fields List**, which only accepts the `apiToken` parameter (a Bearer header
    alone is answered with *The api token field is required.*). A wrong key
    returns HTTP 401 `{"status":"0","message":"Unauthenticated."}`; no key at
    all redirects to the login page.


    **Methods.** Every endpoint accepts both GET and POST with the same
    parameters, except Upload Media, which is POST-only. Use POST for anything
    that changes data.


    **Errors.** Failures usually come back as HTTP 200 with `"status":"0"` and
    the reason in `message`, so always check `status`. `status` is the string
    `"1"` or `"0"` on most endpoints and a boolean on a few.


    **Lists.** Endpoints that return rows put them in `message` as a list; there
    is no `data` field (Custom Fields List is the exception and uses `data`).
servers:
  - url: https://platform.chatsyncs.com/api/v1
security: []
paths:
  /whatsapp/get/post-back-list:
    get:
      tags:
        - WhatsApp API
      summary: Get Post Back List
      operationId: getPostbackList
      parameters:
        - name: apiToken
          in: query
          required: true
          schema:
            type: string
            example: API-KEY
          description: >-
            Your ChatSyncs API key (not a WhatsApp/Meta access token). [Where to
            find it](/developer-api/finding-ids#api-token-apitoken).
        - name: phone_number_id
          in: query
          required: true
          schema:
            type: string
            example: PHONE-NUMBER-ID
          description: >-
            The WhatsApp account's phone number ID. [Where to find
            it](/developer-api/finding-ids#phone-number-id-phone_number_id).
      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: array
                    description: >-
                      The rows, as a list. There is no `data` field on this
                      endpoint.
                    items:
                      type: object
              examples:
                success:
                  summary: Success
                  value:
                    status: '1'
                    message:
                      - id: 3193878
                        user_id: 1
                        postback_id: QUICK_REPLY_LOCATION_REPLY_BOT
                        whatsapp_bot_id: 123
                        use_status: '0'
                        status: '1'
                        whatsapp_bot_setting_id: 4501
                        bot_name: Location quick reply
                        is_template: '1'
                        template_jsoncode: >-
                          [{"messaging_product":"whatsapp","to":"replace_id","type":"text","text":{"body":"Thank
                          you for sharing your location. It has been received.
                          Thank you for being 
                        template_name: Location quick reply
                        template_for: location-quick-reply
                        template_id: null
                        inherit_from_template: '0'
                        whatsapp_bot_label_ids: ''
                        whatsapp_bot_remove_label_ids: ''
                        subscriber_list_ids: null
                        subscriber_list_remove_ids: null
                        remove_sequence_campaign_id: 0
                        team_assign_role_id: 0
                        team_assign_user_id: 0
                        broadcast_sequence_campaign_id: 0
                        visual_flow_type: flow
                        postback_type: main
                        whatsapp_bot_visual_flow_builder_campaign_id: 1358
                        google_sheet_ids: null
                        updated_at: '2026-07-01 17:32:36'
                        row_type: static
                        custom_field_id: 0
                        custom_field_index: ''
                        custom_field_index_title: ''
                        generateGoogleMeetLink: null
                        googleCalendarId: null
                        googleMeetToCustomFieldId: null
                error:
                  summary: A required field is missing
                  value:
                    status: '0'
                    message: The phone number id field is required.
        '401':
          description: >-
            `apiToken` is wrong. (With no token at all the API redirects to the
            login page with HTTP 302 instead of returning JSON.)
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  message:
                    type: string
              examples:
                unauthenticated:
                  summary: Wrong apiToken
                  value:
                    status: '0'
                    message: Unauthenticated.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.