Error Codes

Template Creation Errors

Error	Description	Possible Solution
`2388040` - Character limit exceeded	A field in your template has exceeded the maximum character limit allowed.	Refer to the error message for specific details on the affected field and its corresponding character limits.
`2388047` - Message header format is incorrect	Your message header contains invalid formatting.	Refer to the error message for specific details on valid formatting.
`2388072` - Message body format is incorrect	Your message body contains invalid formatting.	Refer to the error message for specific details on valid formatting.
`2388073` - Message footer format is incorrect	Your message footer contains invalid formatting.	Refer to the error message for specific details on valid formatting.
`2388293` - Parameters words ratio exceeds limit	This template has too many variables for its length. Reduce the number of variables or increase the message length.	Refer to the error message for specific details on valid formatting.
`2388299` - Leading or trailing parameters not allowed	Variables cannnot be at the start or end of the template.	Refer to the error message for specific details on valid formatting.

Message Templates Errors

Error	Description	Possible Solution
`2388019` - Message Template Limit Exceeded	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
`2388001` - Please confirm ownership of this phone number.	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, register and and verify the number.
`2388001` - Please ensure two-step authentication is disabled.	Two-step authentication must be disabled for this phone number.	In your WhatsApp Business Manager Settings, turn off two-step verification.
`2388012` - This phone number already exists in your list of phone numbers.	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.
`2388091`, `2388093` - This phone number isn’t eligible to receive/verify a registration code since it is not being migrated.	Phone ownership verification APIs are not available for this use case.	Register and verify the number.
`2388103` - Cannot migrate phone number.	Webhooks have not been set up for the destination WhatsApp Business account.	Subscribe your app to webhooks on the destination WhatsApp Business account.
`2388103` - Please add this phone number in your WhatsApp account	This phone number is eligible to be added directly, and does not need to use phone migration APIs.	Register and verify the number.
`2388103` - Registered name should be present and approved.	The business phone number must have an approved display name (`name_status` is `APPROVED`) and cannot have any associated pending display name change requests.	Get your business phone number's display name approved.
`2388103` - The WhatsApp account that this phone number is registered with is not set up correctly.	The source WhatsApp Business Account must be approved, and its "messaging on behalf of" must be approved.	The WhatsApp Business Account may be using the now deprecated On-Behalf-Of ownership model. Contact support.
`2388103` - Your WhatsApp account does not have a payment account.	Your WhatsApp account must have an active credit line in order to send messages after migration.	Set up a credit line and share it with the business customer.
`2388103` - There was an error migrating this phone number.	Something went wrong when trying to migrate your phone number.	Try again after some time. If that doesn’t work, contact support.
`2388103` - This phone number belongs to a different Business Manager account.	The source and destination WABAs must represent the same business.	Migrate the phone number into a WhatsApp Business Account that is messaging for the same business as the source WhatsApp Business Account.
`2388103` - Your WhatsApp account must be approved	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.
`2388103` - Your WhatsApp account’s "Messaging For" request must be approved	The destination WhatsApp Business Account "Messaging For" request must be approved by the client.	Ask your client to accept your "Messaging For" request in the Meta Business Suite.
`2494100` - Account is in maintenance mode.	The business phone number is in maintenance mode.	Try again in a few minutes.

Template Insights Errors

Error	Description	Possible Solution
`200005` - Template insights unavailable	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.
`200006` - Cannot disable template insights	Invalid operation. Template Insights cannot be disabled once enabled.	Template insights cannot be disabled once enabled for a WhatsApp Business account.
`200007` - Template Insights not enabled	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

Error	Description	Possible Solution
`2593079` 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.
`2593085` Invalid WhatsApp Business Account for OBO Mobility	The WABA is not eligible for OBO ownership transfer. Possible reasons could be: The WABA is already owned by the business customer (i.e. already uses the WABA Sharing model). The business customer has yet to accept the OBO request in the Business Manager.	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.

2593079

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.

2593085

Invalid WhatsApp Business Account for OBO Mobility

The WABA is not eligible for OBO ownership transfer. Possible reasons could be:

The WABA is already owned by the business customer (i.e. already uses the WABA Sharing model).
The business customer has yet to accept the OBO request in the Business Manager.