All articles
ReferenceTroubleshooting & FAQ

Common Error Codes

Quick reference for understanding API error codes.

1 min read 2 sections 8 tags

HTTP Status Codes

CodeMeaningCommon Causes
400 Bad RequestThe request data is invalid.Missing required fields, invalid values, wrong data types.
401 UnauthorizedYou are not logged in.Session expired, not authenticated. Re-login.
403 ForbiddenYou don't have permission.Your role doesn't allow this action, or you're accessing another organization's data.
404 Not FoundThe resource doesn't exist.Wrong ID, deleted resource, or wrong organization context.
409 ConflictA uniqueness constraint was violated.Duplicate name (cadence, template, group), duplicate email (contact).
422 Unprocessable EntityInvalid state transition.Trying to start an already running campaign, publish an archived cadence.
429 Too Many RequestsRate limit exceeded.Slow down API calls. Wait for the cooldown period.
500 Internal Server ErrorSomething went wrong on the server.Report to support with the request details.
errorsstatus codes400401403404409500