Error codes
Last update: 3 days ago by Irais Aguirre
Error response
When an error occurs, the service responds with an HTTP error status code and the following body. See Error codes.
| Name | Description | Type |
|---|---|---|
| code | Error code. | Integer |
| detail | Error description. | String |
{"code": 2104,"detail": "Template already exists with ID: 572279198452421"}
Error codes
| Code | Description | Solution |
|---|---|---|
| 2 | Parameter 'wbaId' must be not null | The wba_id field is required. |
| 2 | Parameter 'wbaId' is not valid | The WABA ID can only contain digits. |
| 2 | Parameter 'name' is not valid | The template name can only contain letters, numbers, and underscores (_). |
| 2 | Parameter 'category' is not valid | The category must be AUTHENTICATION, MARKETING, or UTILITY. |
| 2 | Parameter 'structure' is not valid | The structure object is required. |
| 2 | Parameter 'body' must be not null | The body object is required inside structure. |
| 2 | Variables can't be at the start or end of the template. | The body text can't start or end with a variable. |
| 2 | Parameter 'Body.type' is not valid | The button type isn't valid. See the accepted values in the buttons object. |
| 2 | Invalid 'message_send_ttl_seconds' for the given category. | The message_send_ttl_seconds value is outside the range allowed for the template category. |
| 2 | Package name must have at least two segments separated by dots, each starting with a letter, and only contain alphanumeric or underscores | The package_name value isn't in the correct format. See the supported_apps object. |
| 2 | Signature hash must be exactly 11 characters, alphanumeric or +, /, = | The signature_hash value must be exactly 11 characters long and contain only alphanumeric characters, +, /, or =. |
| 2 | Parameter 'template_name' must not be null | The template_name parameter is required to delete a template. |
| 2 | Parameter 'url' must be not null | The url field is required to upload media. |
| 5 | Parameter 'Header.format' is not valid | The header format isn't valid. See the header object. |
| 5 | Parameter 'Header.text' must be not null | The header text is required when the format is TEXT. |
| 5 | Invalid 'header_handle'. GIFs only accept mp4 files. | For the GIF format, header_handle must contain URLs of MP4 files. |
| 5 | Parameter 'Button.url' is not valid | The URL of the URL button isn't valid. |
| 5 | Parameter 'Button.phoneNumber' must not be null | The phone_number field is required in PHONE_NUMBER buttons. |
| 5 | Zero tap terms acceptance is required | In zero_tap OTP buttons, the zero_tap_terms_accepted field is required. |
| 5 | Supported apps are required for zero_tap | In zero_tap OTP buttons, the supported_apps field is required. |
| 5 | Parameter 'limited_time_offer.text' must be less than or equal to 16 characters | The limited-time offer text is required and can have up to 16 characters. |
| 7 | WABA Info not found | The information for the WABA you sent wasn't found. |
| 10 | Template not deleted | The template couldn't be deleted. |
| 16 | The number of cards allowed has been exceeded. The maximum number of cards per carousel is 10. | A carousel can have up to 10 cards. |
| 17 | Invalid carousel format. Cards must have a head, a text in the body and, at least, one button. | Each carousel card must have a header, a body, and at least one button. |
| 18 | Invalid carousel head format. The heading of the cards must be multimedia content (image or video). | Card headers only accept the IMAGE and VIDEO formats. |
| 19 | Invalid carousel buttons format. The maximum number of buttons per card is 2. | Each carousel card can have up to 2 buttons. |
| 20 | Invalid carousel buttons type. The allowed buttons type are: PHONE NUMBER, URL, QUICK REPLY. | Card buttons can only be of type PHONE_NUMBER, URL, or QUICK_REPLY. |
| 21 | Invalid carousel buttons format. All the cards must have the same buttons number and type. | All cards must have the same number and type of buttons. |
| 22 | Invalid carousel head format. All the cards must have the same head format. | All cards must use the same header format. |
| 35 | File size (<size>MB) exceeds maximum allowed (<max>MB) for this phone number | The file exceeds the maximum size allowed for header media. |
| 55 | Failed to upload media from the provided URL. Please verify the URL is accessible and try again. | The file at the header URL couldn't be uploaded to Meta. Make sure the URL is public and try again. |
| 56 | Source template not found | The source template doesn't exist in the specified WABA. |
| 57 | Template not found | The template wasn't found locally in the service. |
| 300 | URL Api Graph Read Timeout. Try Again. | Meta didn't respond in time. Try again. |
| 400 | API Graph URL Message=<message>, Code=<code>, SubCode=<subcode>, ErrorUserTitle=<title>, ErrorUserMsg=<msg> | Error returned by Meta. The code is the HTTP status code of Meta's response, and the detail includes its description. |
| 401 | Parameter 'wbaId' not match | The authentication token isn't linked to the WABA you sent. |
| 2104 | Template already exists with ID: <template_id> | A template with the same name and language already exists in the WABA. |
| 3009 | Authorization Server URL JWT token expired | The authentication token has expired. Generate a new one. |