Registration Errors

Registration errors occur during the phone number registration, deregistration, verification, or migration processes. These errors are critical to resolve quickly, as an unregistered or incorrectly registered phone number cannot send or receive WhatsApp messages.

Always use the fbtrace_id from the error response when contacting Meta Support about registration issues.

Error 133000 - Partial Deregister

Incomplete Deregistration — Previous Deregistration Failed

ERROR CODE

133000

ERROR SUMMARY

Incomplete Deregistration — Previous Deregistration Failed

ERROR DESCRIPTION

A previous attempt to deregister the phone number did not complete successfully, leaving the number in an inconsistent state. The number must be fully deregistered before it can be registered again.

HTTP Status: 500 Internal Server Error.

RESOLUTION & TROUBLESHOOTING STEPS

1. Attempt to deregister the phone number again using the Deregister endpoint: DELETE /{phone-number-id}/deregister.

2. After successful deregistration, proceed with registration.

3. If the deregistration fails again, contact Meta Direct Support with the fbtrace_id.

OTHER NOTES

Incomplete deregistrations can occur due to network interruptions or server errors during the deregistration process. Always verify deregistration completion before attempting re-registration.

Error 133004 - Server Unavailable

Server Temporarily Unavailable

ERROR CODE

133004

ERROR SUMMARY

Server Temporarily Unavailable

ERROR DESCRIPTION

The WhatsApp registration server is temporarily unavailable. This is a transient error that typically resolves on its own.

HTTP Status: 503 Service Unavailable.

RESOLUTION & TROUBLESHOOTING STEPS

1. Check the WhatsApp Platform Status page (https://metastatus.com/whatsapp-business-api) for any active outages.

2. Implement exponential backoff retry logic and attempt the registration again after a short delay.

3. Review the 'details' field in the error response for any additional context.

OTHER NOTES

This error should be treated as transient. If it persists for more than 30 minutes, check the Meta status page and consider filing a support ticket.

Error 133005 - PIN Mismatch

Two-Step Verification PIN Mismatch

ERROR CODE

133005

ERROR SUMMARY

Two-Step Verification PIN Mismatch

ERROR DESCRIPTION

The two-step verification PIN included in the registration request does not match the PIN set for the phone number. This is a security error to prevent unauthorized registration of phone numbers.

HTTP Status: 400 Bad Request.

RESOLUTION & TROUBLESHOOTING STEPS

1. Verify that the correct two-step verification PIN is being passed in the 'pin' field of the registration request.

2. If you have forgotten the PIN, disable two-step verification in WhatsApp Manager and set a new PIN.

3. Be aware that there is a rate limit on PIN guesses — too many incorrect attempts will trigger Error 133008.

OTHER NOTES

Two-step verification is a security feature for WhatsApp Business phone numbers. Ensure the PIN is stored securely and is accessible to the system that performs registrations.

Error 133006 - Re-verification

Phone Number Re-verification Needed

ERROR CODE

133006

ERROR SUMMARY

Phone Number Re-verification Needed

ERROR DESCRIPTION

The phone number needs to be re-verified (via SMS or voice OTP) before it can be registered. This occurs when the number has not been verified recently or when the verification has expired.

HTTP Status: 400 Bad Request.

RESOLUTION & TROUBLESHOOTING STEPS

1. Initiate the verification process by calling the Request Code endpoint to send an OTP to the phone number.

2. Enter the received OTP using the Verify Code endpoint.

3. Once verified, retry the registration.

4. Follow the full registration guide at https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/registering-phone-numbers.

OTHER NOTES

This error is common when registering a phone number that was previously registered on a different system or that has been deregistered for a while.

Error 133008 - PIN Attempts

Too Many Two-Step Verification PIN Guesses

ERROR CODE

133008

ERROR SUMMARY

Too Many Two-Step Verification PIN Guesses

ERROR DESCRIPTION

The phone number has been temporarily locked from registration attempts because too many incorrect two-step verification PIN attempts were made.

HTTP Status: 400 Bad Request.

RESOLUTION & TROUBLESHOOTING STEPS

1. Wait for the lockout period to expire. The wait time is specified in the 'details' field of the error response.

2. After the wait period, retry with the correct PIN.

3. To prevent this in the future, ensure the correct PIN is being used and limit the number of automated retry attempts for PIN verification.

OTHER NOTES

This is a security lockout mechanism to prevent brute-force attacks on phone number registrations. Do not attempt to bypass or work around this limit.

Error 133009 - PIN Entered Quickly

Two-Step Verification PIN Entered Too Quickly

ERROR CODE

133009

ERROR SUMMARY

Two-Step Verification PIN Entered Too Quickly

ERROR DESCRIPTION

The two-step verification PIN was entered too quickly after the previous attempt. There is a mandatory minimum time delay between PIN attempts.

HTTP Status: 400 Bad Request.

RESOLUTION & TROUBLESHOOTING STEPS

1. Review the 'details' field for information on the required wait time.

2. Implement a delay between registration retry attempts in your provisioning code.

3. Do not implement tight retry loops for registration — allow sufficient time between attempts.

OTHER NOTES

This error is typically encountered in automated registration pipelines that retry too aggressively. Add a minimum 30-second wait between registration attempts as a best practice.

Error 133010 - Not Registered

Phone Number Not Registered on WhatsApp Business Platform

ERROR CODE

133010

ERROR SUMMARY

Phone Number Not Registered on WhatsApp Business Platform

ERROR DESCRIPTION

The phone number is not currently registered on the WhatsApp Business Platform. This error occurs when trying to send messages or perform operations on a phone number that has not completed the registration process.

HTTP Status: 400 Bad Request.

RESOLUTION & TROUBLESHOOTING STEPS

1. Register the phone number using the Registration API before attempting to send messages.

2. Follow the registration guide at https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration.

3. Verify registration was successful by checking the phone number status in WhatsApp Manager.

OTHER NOTES

In Chakra Chat, all configured phone numbers are automatically checked for registration status. Unregistered numbers will show a warning indicator in the phone number settings.

Error 133015 - Recently Deleted

Please Wait Before Re-registering a Recently Deleted Phone Number

ERROR CODE

133015

ERROR SUMMARY

Please Wait Before Re-registering a Recently Deleted Phone Number

ERROR DESCRIPTION

The phone number you are attempting to register was recently deleted, and the deletion process has not yet completed. WhatsApp requires a waiting period before a recently deleted number can be re-registered.

HTTP Status: 400 Bad Request.

RESOLUTION & TROUBLESHOOTING STEPS

1. Wait approximately 5 minutes before retrying the registration request.

2. If after 5 minutes the error persists, wait an additional 5–10 minutes before retrying again.

3. Check WhatsApp Manager to confirm the phone number has been fully removed before attempting re-registration.

OTHER NOTES

Phone number deletion and re-registration workflows should always include this waiting period in the provisioning logic to avoid this error.

Error 131045 - Incorrect Certificate

Incorrect Certificate — Phone Number Registration Error

ERROR CODE

131045

ERROR SUMMARY

Incorrect Certificate — Phone Number Registration Error

ERROR DESCRIPTION

The message failed because the phone number has a registration certificate issue. This typically means the phone number was not properly registered with the WhatsApp Cloud API.

HTTP Status: 500 Internal Server Error.

RESOLUTION & TROUBLESHOOTING STEPS

1. Deregister the phone number and then re-register it using the correct registration flow.

2. Follow the registration documentation at https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration.

3. Ensure the registration is completed successfully before attempting to send messages.

OTHER NOTES

This error can occur if a phone number was migrated between WABAs or systems without following the correct migration procedure. Always use the official migration APIs for phone number transfers.