WhatsApp Business Account Phone Number Verification - Verify Code API | Developer Documentation

Troubleshoot the code used to verify your phone number

The supplied ChatArchitect connection flow verifies control of your business number by SMS or voice call. This ownership code is separate from the two-step verification PIN. Use this checklist if the code does not arrive or the connection flow rejects it.

Check the number and receiving method

1. Return to the step showing the intended business number. Check the country selection and the entered number against the number you control.
2. Confirm that you can receive the selected SMS or call on that number. For a landline or toll-free number, check whether an IVR, forwarding or another phone system prevents the verification call from reaching you. The number preparation guide covers these prerequisites.
3. Follow any waiting or retry instructions displayed by the active connection flow. Use the method it offers; this guide does not set a universal retry interval or number of attempts.

If a code arrives but is rejected

Enter the code in the active verification step for that number, following the screen's instructions. Check that you have not switched to another account or a different number. If you requested another code, follow the flow's guidance on which request is current.

If the screen asks for a two-step verification PIN, use the PIN guide. An SMS ownership code and a PIN belong to different checks. Keep both private and redact them from support screenshots.

Check which stage remains unfinished

Record whether the failure happens before requesting the code, while receiving it, after submitting it or after returning to ChatArchitect. Successful code verification alone does not demonstrate that a CRM or custom service is ready to send and receive messages; compare the intended number and connection separately.

If the number already uses the WhatsApp Business app, use the joint-operation guide and confirm the route with support. The exact entry path requires confirmation for that case.

Report the failure

Provide the business number, selected SMS or call method, attempt time, screen and exact error text. Include whether the number receives ordinary SMS or calls. Share a screenshot with the code and PIN removed. Customers complete the supplied connection flow; this guide does not ask you to submit a code to Meta's Graph API.