Errors and Rate Limits | Documentation

Lead Receive API errors use standard HTTP status codes and machine-readable code values where available.

Common errors

Code	HTTP status	Meaning
`AUTH_FAILED`	`401`	Missing, invalid, or expired API key.
`INVALID_REQUEST`	`400`	Request body or lead format is invalid.
`AGENT_NOT_FOUND`	`404`	Agent does not exist, is inactive, or does not belong to the company.
`RATE_LIMIT_EXCEEDED`	`429`	Too many requests for the agent.
`INTERNAL_ERROR`	`500`	SimZ could not complete the request.

Retry 429 only after the indicated delay. Retry 5xx with exponential backoff. Do not retry validation errors until the request is corrected.