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. |
| 1002 | Too many failed logins |
| 1403 | Unauthorized action: this team user does not have access to the specified items. |
