Rate limits and error handling

Refer to our list of error codes for troubleshooting help.

Rate limits

All endpoints are rate limited. Check the response codes for a 429 error, which indicates you have hit a rate limit, and retry requests that exceed the rate limit at a later time. If you consistently hit rate limits, we recommend adjusting your request-rate using an exponential backoff algorithm.

Errors

Our API uses conventional HTTP response codes to indicate success or failure of an API request. Errors typically fall into three ranges:

  • 2xx - Success
  • 4xx - Error as a result of information provided as part of the request, such as a requested object that doesn't exist, an invalid setting, etc.
  • 5xx - Error due to Klaviyo

The response of all API errors contain a message parameter which has developer-facing information about why the request failed.

See the table below for a list of error codes and their corresponding descriptions:

Code

Summary

Description

200

OK

The request completed successfully

400

Bad Request

Request is missing or has a bad parameter

400

Not Authorized

Request is missing or has an invalid API key

401

Not Authorized

Key is valid, but account does not have permissions to perform this action

403

Forbidden

Request is missing or has an invalid API key

404

Not Found

The requested resource doesn't exist

429

Rate Limit

You hit the rate limit for this endpoint (different endpoints have different rate limits)

500

Server Error

Something is wrong on Klaviyo's end


Did this page help you?