---
title: "Whatsapp Connect"
method: POST
path: "/integrations/whatsapp/connect"
tags: ["whatsapp"]
---

# Whatsapp Connect

`POST /integrations/whatsapp/connect`

## Request

- Base URL: `https://api.getanana.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getanana.com/integrations/whatsapp/connect`
- Auth: none declared

Finish Embedded Signup and save the tenant's WhatsApp connection.

All five Meta calls run before anything is written, so a failure at any
step leaves no half-connected row. The tenant's row is revived or replaced
in place, never duplicated. When the number changes, the old number's
assistant endpoints go: guests texting it are no longer ours to answer.

## Request body

- WhatsAppConnectRequest: What Embedded Signup handed the browser. ``code`` expires 30 seconds after Meta issues it, so the browser posts this the moment the popup finishes. The ids come from the ``WA_EMBEDDED_SIGNUP`` message event, the code from the login callback.
  - `code` string, required
  - `waba_id` string, required
  - `phone_number_id` string, required
  - `business_id` string, required

## Response `200`

Successful Response

- WhatsAppNumberStatus
  - `tenant_integration_id` string, uuid, required
  - `phone_number_id` string, required
  - `display_phone_number` string, required
  - `verified_name` string, required
  - `quality_rating` string, nullable
  - `connected_at` string, date-time, nullable
  - `token_expires_at` string, date-time, nullable
  - `templates` WhatsAppTemplateStatus[]
    - `name` string, required
    - `purpose` string, required
    - `status` string, required
    - `category` string, nullable
    - `reason` string, nullable
    - `updated_at` string, date-time, required

## Other responses

- `422`: Error
- `502`: Error
- `503`: Error

## Changes

> 55 revisions in range; 1 not diffed.

- **2026-10-15** `fb3ce6ade802`: 1 info
  - added the optional property `templates` to the response with the `200` status
- **2026-10-14** `94fc7fe82074`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getanana/apis/cleon-api/changes/integrations/whatsapp/connect/post.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/4d9d38769a75?raw)