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

# WABA API Overview

> Manage WhatsApp Business Platform (WABA) conversations, messages, templates, and accounts programmatically

# WABA API

The WABA endpoints extend the TimelinesAI Public API to the WhatsApp Business Platform (Cloud API). Use them to work with WABA chats and messages, manage message templates, read account analytics, and organize conversations with labels — all through the same REST API and Bearer authentication as the rest of the Public API.

## Base URL

```
https://app.timelines.ai/integrations/api
```

All requests require Bearer token authentication. See [Authentication](/docs/authentication) for details.

## Capabilities

<CardGroup cols={2}>
  <Card title="Chats" icon="comments" href="/docs/public-api-reference/waba/get-full-or-filtered-list-of-all-waba-chats-in-the-workspace">
    List, filter, get, and update WABA chats.
  </Card>

  <Card title="Messages" icon="paper-plane" href="/docs/public-api-reference/waba/send-waba-message-to-phone-number">
    Send WABA messages by phone number or in an existing chat, and retrieve message details and status history.
  </Card>

  <Card title="Reactions" icon="face-smile" href="/docs/public-api-reference/waba/get-the-current-reaction-for-a-waba-message">
    Get, set, and clear emoji reactions on WABA messages.
  </Card>

  <Card title="Labels" icon="tags" href="/docs/public-api-reference/waba/list-labels-for-the-specified-waba-chat">
    Organize WABA chats with labels — list, add, and replace.
  </Card>

  <Card title="Accounts" icon="phone" href="/docs/public-api-reference/waba/get-the-list-of-all-waba-accounts-in-the-workspace">
    List WABA accounts and request account-level messaging analytics.
  </Card>

  <Card title="Templates" icon="table-cells" href="/docs/public-api-reference/waba/get-the-list-of-all-waba-templates-in-the-workspace">
    List and inspect approved WABA message templates.
  </Card>
</CardGroup>

## Available endpoints

| Group         | Endpoints                                                                                                                                                                                 | Description                                        |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| **Chats**     | `GET /waba/chats`, `GET /waba/chats/{chat_id}`, `PATCH /waba/chats/{chat_id}`                                                                                                             | List, get details, and update WABA chats           |
| **Messages**  | `POST /waba/messages`, `POST /waba/chats/{chat_id}/messages`, `GET /waba/chats/{chat_id}/messages`, `GET /waba/messages/{message_uid}`, `GET /waba/messages/{message_uid}/status_history` | Send WABA messages and retrieve history and status |
| **Reactions** | `GET /waba/messages/{message_uid}/reactions`, `PATCH /waba/messages/{message_uid}/reactions`                                                                                              | Read, set, and clear WABA message reactions        |
| **Labels**    | `GET /waba/chats/{chat_id}/labels`, `POST /waba/chats/{chat_id}/labels`, `PUT /waba/chats/{chat_id}/labels`                                                                               | List, replace, and add WABA chat labels            |
| **Accounts**  | `GET /waba/accounts`, `GET /waba/accounts/{account_id}`, `POST /waba/accounts/{account_id}/analytics`, `GET /waba/accounts/{account_id}/analytics/{handle_id}`                            | List accounts and request/poll account analytics   |
| **Templates** | `GET /waba/templates`, `GET /waba/templates/{template_id}`                                                                                                                                | List and get WABA message templates                |

<Info>
  A failed WABA message exposes a structured `failure_reason` object with `code`, `title`, and `details` — see [Get WABA Message](/docs/public-api-reference/waba/get-the-details-of-a-waba-message-specified-by-the-messages-uid).
</Info>