Error codes

The invalid or error API calls have the following response structure:
"message": "Failed to send a message because more than 24 hours have passed since the customer last replied",
"userTitle": "Failed to send a message because more than 24 hours have passed since the customer last replied",
"userMessage": "Pass along the connectly trace id 'cnct_trace_id' to the team for more information.",
"cntTraceId": "11824978358485860716",
"details": {}
  • message - the description of the error
  • type - the error type, please see the section below for more details
  • code - a specific error instance
  • userTitle - an expanded error description
  • userMessage - the user instructions for troubleshooting
  • cntTraceId - Connectly trace ID, used by Connectly engineers for troubleshooting
  • details - more details

Error Codes

ERROR_CODE_INVALID_SENDER_ID - the phone number is not valid
ERROR_CODE_PHONE_NUMBER_BAD_FORMAT - bad phone format number
ERROR_CODE_MESSAGE_ATTACHMENTS_NUMBER_INVALID - invalid number of attachments, currently Connectly API supports only one attachment at a time
ERROR_CODE_MESSAGE_TEXT_EMPTY - message text is empty
ERROR_CODE_MESSAGE_TEMPLATE_NOT_FOUND - the template for the specified name and language does not exist, please create it first
ERROR_CODE_MESSAGE_TEMPLATE_INPUT_INVALID - message template inputs are not valid
ERROR_CODE_MESSAGE_ATTACHMENT_EMPTY - message attachment URL is empty
ERROR_CODE_MESSAGE_ATTACHMENT_INVALID - message attachment URL is invalid and can't be parsed
ERROR_CODE_BUSINESS_MISSES_MATCHING_CHANNEL - business is missing sender channel of matching channel type
ERROR_CODE_MESSAGE_OUTSIDE_OF_ELIGIBILITY_WINDOW - failed to send a message because more than 24 hours have passed since the customer last replied
ERROR_CODE_BUSINESS_REACHED_LIMITS - business reached the restrictions on how many messages can be sent from this channel. Too many previous messages were blocked or flagged as spam
ERROR_CODE_MESSAGE_SELF_INVALID - this message type can't be sent to yourself. Please use a different receiver
ERROR_CODE_MESSAGE_CUSTOMER_OPTED_OUT - customer opted out of receiving template messages
ERROR_CODE_MESSAGE_CUSTOMER_NO_CONVERSATION_INITIATION - you can not use the send message API when the customer has not performed the initial reach out, check out our send templated message API
ERROR_CODE_BUSINESS_KEY_SECRET_ABSENT - business API secret is not initialized. Please initialize it or contact Connectly team for more information
ERROR_CODE_MESSAGE_TEMPLATE_DELETED - new language content can't be added while the existing language content is being deleted. Try again in 4 weeks or consider creating a new message template
ERROR_CODE_MESSAGE_TEMPLATE_INVALID_PARAM - invalid message template parameter is provided, please check that all the template message variables, buttons, and parameters are present and correct
ERROR_CODE_BUSINESS_RATE_LIMIT_REACHED - business reached the rate limit

Error Types

ERROR_TYPE_UNSPECIFIED - unexpected error type, please contact the team to understand more. ERROR_TYPE_AUTHENTICATION - invalid authentication credentials (e.g invalid API key). ERROR_TYPE_AUTHORIZATION - no authorization found for the resource (e.g API key does not have access to business_id). ERROR_TYPE_RATE_LIMIT - the API rate limit is exceeded, please wait for couple minutes and try again. ERROR_TYPE_INVALID_REQUEST - the request payload is not valid, please refer to the API documentation and fix the request payload. ERROR_TYPE_DEADLINE_EXCEEDED - request time out, please contact the team to understand more. ERROR_TYPE_NOT_FOUND - the requested resource does not exist. ERROR_TYPE_CONFLICT - the resource already exists and the new one can not be created, please use the update operation instead of create. ERROR_TYPE_CONTEXT_CANCLED - the client requested the timeout, please check your HTTP client parameters and increase the time-out limit. ERROR_TYPE_BUSINESS_LIMIT - the business has reached the account limits.