ℹ️ Troubleshooting tip

This page documents platform level API error codes returned in 8x8 API responses.

For delivery related errors coming back after we hand messages to suppliers, see the Messaging Apps Delivery Receipt Error Codes reference and SMS Delivery Receipt Error Codes

HTTP Error Codes

8x8 API might return the following HTTP error codes:

All API responses with HTTP code 400 and above has the following properties:

• code (integer) - Error code
• message (string) - Human-readable error description
• errorId (UUID) - Unique id of the error. You can use it as a reference when sending inquiries to 8x8 support.
• timestamp (string, date-time) - Date and time of the error occurrence. Format: yyyy-MM-ddTHH:mm:ss.ffZ

Example of error JSON object returned by the API

{
"code":1300,
"message":"Object wasn't found or is already expired",
"errorId":"1cc1eda1-f5dd-ea11-8288-0263195dd35a",
"timestamp":"2020-12-22T05:52:01.85Z"
}

API Response Property Values

The table below refers to the possible values of the "code" parameter, in the response body returned by the API as shown above. They can be used for additional clarity of what type of error was encountered.

SMS API, Messaging API