Errors

Errors use standard HTTP status codes and always have the same body. code is stable, so check it in your code. message is for people and can change.

Response
{
  "error": "Not Found",
  "code": "contact_not_found",
  "message": "Contact 'jane.fitness' not found for this organization."
}
StatusMeaning
400Something in the request is invalid: a parameter, a body field, or a body that is not valid JSON (invalid_body). message says what.
401The API key is missing or wrong.
403API access is off, the subscription is cancelled, or an email belongs to someone outside your organization.
404The contact, tag or stage does not exist.
405Wrong HTTP method for this path.
409The request conflicts with the current state, for example the contact already exists.
429Rate limit reached. Wait for Retry-After seconds.
500Something went wrong on our side. Retry later.
503query_timeout: the request took too long, retry with a smaller limit or narrower filters. service_unavailable: a short outage, retry after Retry-After seconds.
Link copied