Zernio API Docs

Appearance

List WhatsApp phone numbers for selection ​

Fetch the WhatsApp phone numbers available across the user's WhatsApp Business Accounts (WABAs) after a headless OAuth flow.

WhatsApp OAuth grants access at the WABA level. When a connected WABA has 2 or more phone numbers, you must call this endpoint to list them and then POST /v1/connect/whatsapp/select-phone-number to bind one to the Zernio profile. Single-phone WABAs auto-complete during the OAuth callback and never reach this endpoint.

Use the profileId and tempToken returned in the headless redirect (step=select_phone_number).

Alternative: if you already know wabaId and phoneNumberId (e.g. from Meta Business Suite), use connectWhatsAppCredentials instead, which skips this two-step flow.

GET /v1/connect/whatsapp/select-phone-number ​

Fetch the WhatsApp phone numbers available across the user's WhatsApp Business Accounts (WABAs) after a headless OAuth flow.

WhatsApp OAuth grants access at the WABA level. When a connected WABA has 2 or more phone numbers, you must call this endpoint to list them and then POST /v1/connect/whatsapp/select-phone-number to bind one to the Zernio profile. Single-phone WABAs auto-complete during the OAuth callback and never reach this endpoint.

Use the profileId and tempToken returned in the headless redirect (step=select_phone_number).

Alternative: if you already know wabaId and phoneNumberId (e.g. from Meta Business Suite), use connectWhatsAppCredentials instead, which skips this two-step flow.

Parameters ​

  • profileId (query, string) required — The Zernio profile ID from the headless redirect

  • tempToken (query, string) required — The temporary access token from the headless redirect

  • X-Connect-Token (header, string) — Alternative auth for API users' end customers (used when the bearer token is scoped to a different user)

Responses ​

200 — Phone numbers fetched successfully

  • phoneNumbers (array)

400 — Missing profileId or tempToken

  • error (string)
  • details (object)

401

500 — Failed to fetch phone numbers (Meta API error, expired token, or insufficient permissions)

  • error (string)
  • details (object)