Error Codes
Message Templates Errors
| Error | Description | Possible Solution |
|---|---|---|
| You have exceeded the maximum number of message templates you can have for this WhatsApp business account. | A WhatsApp Business Account can have up to 250 message templates. Learn more. |
Phone Migration Errors
| Error | Description | Possible Solution |
|---|---|---|
| Certificate can be downloaded only after confirming ownership of a phone number that is being migrated. | In order to download the certificate and proceed with registration, request for a registration code and verify it. Learn more. |
| Two-step authentication must be disabled for this phone number. | In your WhatsApp Business Manager Settings, turn off two-step authentication. Learn more. |
| The phone number you are trying to migrate is already present in your WhatsApp account. | Try again with a phone number that is not already present in your WhatsApp account. |
| Phone ownership verification APIs are not available for this use case. | Register and verify the number. Learn more. |
| Webhooks have not been set up for the destination WhatsApp Business account. | Subscribe your app to webhooks for the destination WhatsApp Business account. Learn more. |
| This phone number is eligible to be added directly, and does not need to use phone migration APIs. | Add the phone number to your WhatsApp account from Business Manager directly, and proceed with registration. Learn more. |
| The business phone number must have an approved display name ( | Get your business phone number's display name approved. See Display Names. |
| The source WhatsApp Business Account must be approved, and its "messaging on behalf of" must be approved. | Work with the business that owns the source WhatsApp Business Account to set up the account correctly or to deactivate it, and then retry migration. Learn more. |
| Your WhatsApp account must have an active credit line in order to send messages after migration. | Set up a credit line for your WhatsApp account, or share your credit line. Learn more. |
| Something went wrong when trying to migrate your phone number. | Try again after some time. If that doesn’t work, contact support. Learn more. |
| The source and destination WABAs must represent the same business. | Migrate your phone number into a WhatsApp Business Account that is messaging for the same business as the source WhatsApp Business Account. Learn more. |
| The destination WhatsApp Business Account must be approved before you can migrate phone numbers. | Ensure business verification is completed, and the WhatsApp Business Account review status is approved. Learn more. |
| The destination WhatsApp Business Account "Messaging For" request must be approved by the client. | Ask your client to accept your "Messaging For" request. Learn more. |
| The business phone number is in maintenance mode. | Try again in a few minutes. |
Template Insights Errors
| Error | Description | Possible Solution |
|---|---|---|
| Template insights are not available yet for this WhatsApp Business account. | You are unable to enable template insights for this WhatsApp Business account at the moment. |
| Invalid operation. Template Insights cannot be disabled once enabled. | Template insights cannot be disabled once enabled for a WhatsApp Business account. |
| Template Insights have not been enabled for this WhatsApp Business Account | To enable template insights, see Template Analytics. |
WhatsApp Business Account Errors
| Error | Description | Possible Solution |
|---|---|---|
Template insights unavailable | This WABA has already been marked for migration to a different solution ID | Proceed to the next step in the transfer process. See Transferring Ownership of a WABA. |
Invalid WhatsApp Business Account for OBO Mobility | The WABA is not eligible for OBO ownership transfer. Possible reasons could be:
| Target a WABA that uses the OBO model, or instruct the customer to accept the OBO request in the Business Manager, then attempt to transfer ownership again. |