Phone Numbers

Request the WhatsApp verification code for a number

Starts (or restarts) WhatsApp verification of a Zernio-hosted number: adds it to Meta's pre-verified pool when needed and asks Meta to send the verification code, which Zernio captures on the number itself. Used to connect WhatsApp on a number bought for calls or SMS. /v1/whatsapp/phone-numbers/{id}/request-code is a deprecated alias with the same contract.

When Meta refuses the number for WhatsApp (Meta error 136021): a number that is already live (active or suspended) is left untouched and keeps working for calls and SMS, and the call answers 409 number_not_whatsapp_eligible; buy a new number with WhatsApp enabled instead. A number that was never live (still verifying) is replaced at no extra cost with a WhatsApp-eligible number on the same record, answered as 200 with replaced: true.

post/v1/phone-numbers/{id}/whatsapp/request-code

Path parameters

idstring required

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

Request body

method'SMS' | 'VOICE'

Delivery method for the code. Omit to let Zernio pick (SMS when the number can receive it, else VOICE).

Response

Code requested, or the number was already verified, or a never-live number was replaced.

messagestring
method'SMS' | 'VOICE'
alreadyVerifiedboolean

Meta already reports the number as verified. No code is sent and the number is activated.

replacedboolean

Meta refused the original number, which had never been live, so it was replaced on the same record.

newPhoneNumberstring

The replacement number, present when replaced is true.

Changes

Changed in 2 of the 68 revisions of this API.31

    • ●

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

      response-property-enum-value-added

    • ●

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

      response-property-enum-value-added

    • ●

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

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ○

      endpoint added

      endpoint-added