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.