v2
latestOpenAPI 3.1.02026-08-075421692.0 MBList 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.
Query parameters
The Zernio profile ID from the headless redirect
The temporary access token from the headless redirect
Headers
Alternative auth for API users' end customers (used when the bearer token is scoped to a different user)
Response
Phone numbers fetched successfully