API Reference
DashboardGet API keyAPI key

Getting started

  • Introduction
  • Authentication
  • Errors & rate limits

Voice agents

WhatsApp agents

    • Overview
    • GETList accounts
    • GETGet account

Workspace

WhatsApp agentsWhatsApp accounts

WhatsApp accounts

The WhatsApp Business numbers connected to your workspace.

A WhatsApp account is one phone number connected through Meta's WhatsApp Business Platform. Your WhatsApp agent answers the messages that arrive on it.

Numbers are connected in the dashboard through Meta's signup flow, so accounts are read-only in the API. Use an account's phone_number_id as an agent's set_inbound_whatsapp_number to route its messages to that agent.

Endpoints

GETList accounts/whatsapp/accountsGETGet account/whatsapp/accounts/{id}

The WhatsApp account object

  • idstring (uuid)

    WhatsApp account id.

  • waba_idstring

    Meta WhatsApp Business Account id.

  • phone_number_idstring

    Meta phone number id. Use it as an agent's set_inbound_whatsapp_number.

  • display_e164stringnullable

    The number in E.164 format.

  • statusstring

    Connection status, e.g. active.

  • modestring

    cloud_api or coexistence (number also used in the WhatsApp Business app).

    Allowed:cloud_apicoexistence
  • created_atstring (date-time)nullable

    When the number was connected.

  • updated_atstring (date-time)nullable

    When it was last changed.

The WhatsApp account object
{
  "id": "a9b8c7d6-e5f4-4a3b-9c2d-1e0f9a8b7c6d",
  "waba_id": "102938475610293",
  "phone_number_id": "109876543210987",
  "display_e164": "+918045678901",
  "status": "active",
  "mode": "cloud_api",
  "created_at": "2026-10-20T09:15:42.120Z",
  "updated_at": "2026-10-24T14:03:11.508Z"
}
PreviousGet call statsNextList accounts