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

# Whatsapp Connect

`POST /integrations/whatsapp/connect`

Complete Embedded Signup: exchange the code, store the connection, and
onboard the phone number (register + subscribe webhooks).

## Request body

- WhatsAppConnectRequest
  - `code` string, required — Exchangeable token code from Embedded Signup
  - `waba_id` string, nullable — Customer WABA ID from the ES message event. Optional: when the browser handoff is blocked we discover it from the exchanged token.
  - `phone_number_id` string, nullable — Customer business phone number ID (absent for WABA-only signups)
  - `business_id` string, nullable — Customer business portfolio ID
  - `agent_id` string, nullable — Optional agent to attach the number to

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/agentphone/apis/agentphone-api.md) · [All operations](https://skmtc.net/agentphone/apis/agentphone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agentphone/agentphone-api/revisions/99a2d19dd0fd/schema)