---
title: "Complete number selection"
method: POST
path: "/v1/connect/whatsapp/select-phone-number"
tags: ["Connect"]
---

# Complete number selection

`POST /v1/connect/whatsapp/select-phone-number`

Bind a specific WhatsApp phone number to the Zernio profile after the user picks one from `listWhatsAppPhoneNumbers`. Exchanges the short-lived OAuth token for a long-lived token, subscribes the WABA to webhooks, and creates the SocialAccount.

## Headers

- `X-Connect-Token` string

## Request body

- object
  - `profileId` string, required — The Zernio profile ID
  - `phoneNumberId` string, required — The selected phone number ID (from listWhatsAppPhoneNumbers)
  - `wabaId` string, required — The WABA ID containing the selected phone
  - `tempToken` string, required — The temporary access token from the headless redirect
  - `userProfile` object — Optional user profile data (passthrough)
  - `redirect_url` string — Optional URL to receive the post-connection redirect target

## Response `200`

Phone number connected successfully

- object
  - `message` string
  - `redirect_url` string — Present only if redirect_url was provided in the request
  - `account` object
    - `accountId` string
    - `platform` 'whatsapp'
    - `username` string — Display phone number
    - `displayName` string — Meta-verified business name
    - `isActive` boolean
    - `selectedPhoneNumber` string

## Other responses

- `400` — Missing required fields (profileId, phoneNumberId, wabaId, or tempToken)
- `401` — Unauthorized
- `403` — Profile limit exceeded for the user's plan (PROFILE_LIMIT_EXCEEDED)
- `404` — Selected phone number not found in the specified WABA
- `409` — The phone number is a Zernio-provisioned number pinned to a different profile. Connect it from that profile, or move it first with PATCH /v1/whatsapp/phone-numbers/{id}/profile.
- `500` — Failed to bind phone number

---

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