Connect

List numbers for selection

Changed on

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

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/connect/whatsapp/select-phone-number
  • Auth: HTTP bearer

Query parameters

profileIdstring required

The Zernio profile ID from the headless redirect

tempTokenstring required

The temporary access token from the headless redirect

Headers

X-Connect-Tokenstring

Alternative auth for API users' end customers (used when the bearer token is scoped to a different user)

Response

Phone numbers fetched successfully

Changes

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

  • d556591af3f6Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status