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