Handling errors
This API will return a 4xx http response code on wrong input and sends a human readable error back.
Example failed response:
Status code: 400 Bad Request,
Body:
{
"error": "error parsing json"
}
OR
{
"error": "104"
"errorMsg": "Invalid credentials"
}
| Error | Explanation |
|---|---|
| 102 | No message provided |
| 103 | Phone number is required or invalid |
| 104 | Invalid Credentials |
| 105 | We are currently having issues with our servers. Please try again later |
| 106 | Destination number [xxxx] missing or invalid |
| 108 | Not enough credits. |
| 109 | Sender name cannot be empty |
| 110 | You used the sender number, this always has to start with a +. |
| 111 | You are using an invalid sender name. This field can be maximum 11 characters or 14 digits long |
| 112 | Message Required |
| 113 | Order Required |
| 114 | Empty Request |
| 116 | Access disabled because long time no usage, contact support |
| 118 | An sms message cannot be longer than 612 characters. Some special characters, like €, count as 2 |
| 121 | Date [xxxx] is invalid or in the past. |
| 122 | No contacts sent |
| 123 | Object didn't have an ID |
| 124 | Parameter groupid required |
| 125 | Group not found |
| 126 | Name is required |
| 128 | Group [xxxx] not found |
| 129 | Number [xxxx] already exists in group |
| 131 | This number is on your opt-out list. This person does not want to receive messages. |
| 132 | Inbox not found |
| 133 | Message not found |
| 134 | Webhook ID not found |
| 135 | If set, the limit parameter must be a integer bigger than 0 and not bigger than 2000 |
| 136 | If set, the page parameter must be a integer bigger than 0 |
| 137 | The 24H Window is not open, please send a template message instead |
| 138 | Unable to send message due to misconfiguration, please contact support. |
| 139 | Missing or invalid parameters provided. Please check the errorMsg for more information. |
| 140 | Invalid or missing WhatsApp Business account. |
| 143 | Team member not found: team_member is not an active team member of your account. |
| 144 | Invalid conversation status [xxxx]; use open, pending or closed. |
| 145 | Invalid conversation key [xxxx]. Use a phone number in international format, a WhatsApp user ID (BE.…, WA.LID…) or group:gid_… |
| 146 | API credential not found (or already revoked) for this white label account. |
| 147 | Parameter name is required and must be between 1 and 100 characters (API credentials). |
| 148 | Invalid ip_restriction entry [xxxx]; use a list of IPv4/IPv6 addresses or CIDR ranges. |
| 149 | Invalid endpoint_restrictions; use a list of {method, path} objects with method GET, POST, PUT, PATCH or DELETE. |
| 150 | Template [xxxx] not found (parameter template of /v1/message/send and /v1/voice/send). |
| 151 | Invalid funds amount [xxxx] |
| 152 | Purchasing funds through the API is not available for this account [xxxx] |
| 153 | Order [xxxx] not found |
| 154 | The payment provider could not create a checkout session, please try again later |
| 155 | Invalid [xxxx]; use a public https URL |
| 156 | Virtual numbers for country [xxxx] cannot be purchased through the API, contact support |
| 157 | Virtual number [xxxx] is not available |
| 158 | Purchasing virtual numbers through the API is not available for this account [xxxx] |
| 159 | Invalid billing_cycle [xxxx]; only "monthly" is available through the API |
| 160 | Too many open virtual number orders; pay or cancel an open order first |
| 161 | Order [xxxx] is already paid and cannot be cancelled |
| 162 | Conversation [xxxx] not found: no message was ever sent to or received from it, so there is nothing to assign. |
| 163 | Flow [xxxx] not found |
| 164 | Invalid flow definition: [xxxx] (error_info lists every problem as { path, message }) |
| 165 | Flow cannot be published: [xxxx] (error_info lists every problem as { path, message }) |
| 166 | Flow automations are not available for this account [xxxx] |
| 167 | Flow execution [xxxx] not found |
| 168 | Maximum number of flows reached ([xxxx]) |
| 169 | Template [xxxx] has an attachment and can only be sent through WhatsApp; use /v1/whatsapp/send_file |
| 200 | Access to the gateway API is not allowed because your IP address is not allowed. Also returned (http status code 403) as "Access through the Tor network is not allowed." for requests from a Tor exit node. |
| 1002 | Too many failed logins Http status code 401: too many failed logins from your IP address today. Http status code 429: too many failed logins on this account from other IP addresses. Addresses that used this account successfully in the last 30 days keep working; others are refused until 15 minutes pass without a failed login. |
| 1403 | Unauthorized action: this team user does not have access to the specified items. |
