Errors
Overview
Pinpoint uses conventional HTTP response codes to indicate the success or failure of an API request.
In general:
- Codes in the 2xx range indicate success.
- Codes in the 4xx range indicate an error that failed given the information provided (e.g., authentication failed.).
- Codes in the 5xx range indicate an error with Pinpoint's servers.
Some 4xx errors that could be handled programmatically include additional details that briefly explains the error reported.
Examples
Code | Description |
---|---|
200 - OK 201 - Created | Everything worked as expected. |
400 - Bad Request | The request was unacceptable. E.g. Malformed payload |
401 - Unauthorized | No API key provided or API key invalid. |
403 - Forbidden | Integration not enabled |
404 - Not Found | The requested resource doesn't exist. |
422 - Unprocessable Entity | The request couldn't be made, likely due to validation errors. |
429 - Too Many Requests | Rate limit exceeded. |
500 - Internal Server Error | Something went wrong on our end. Our developers will be notified of the issue. |
Updated over 3 years ago