WhatsApp Calling

Start caller-ID verification for a customer-brought number

Changed on

Customer-brought (BYO) WhatsApp numbers cannot present themselves as caller ID on tel: call forwards until verified (carrier anti-spoofing); until then forwarded calls show a Zernio number (callerIdMode: platform on the calling config). This sends a one-time code to the number by SMS or voice call. Re-POST to resend. Zernio-purchased numbers never need this and get a 400.

post/v1/phone-numbers/{id}/whatsapp/caller-id-verification

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/phone-numbers/{id}/whatsapp/caller-id-verification
  • Auth: HTTP bearer

Path parameters

idstring required

Phone number record ID (from GET /v1/phone-numbers).

Request body

method'sms' | 'call'

Response

Code sent (or the number was already verified)

verifiedboolean
codeSentboolean
method'sms' | 'call'

Changes

  • 03d976303e39Revision changes
    • info

      added the non-success response with the status

  • 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