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. |
