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

CodeDescription
200 - OK
201 - Created
Everything worked as expected.
400 - Bad RequestThe request was unacceptable. E.g. Malformed payload
401 - UnauthorizedNo API key provided or API key invalid.
403 - ForbiddenIntegration not enabled
404 - Not FoundThe requested resource doesn't exist.
422 - Unprocessable EntityThe request couldn't be made, likely due to validation errors.
429 - Too Many RequestsRate limit exceeded.
500 - Internal Server ErrorSomething went wrong on our end. Our developers will be notified of the issue.