Skip to main content
Error Handling

Error Handling

Understand error responses and implement robust error handling.

Error Response Format

Error Response
{
  "error": {
    "code": "CONTACT_NOT_FOUND",
    "message": "Contact with ID 'abc123' not found",
    "request_id": "req_xyz789",
    "documentation_url": "https://docs.synaptis.com/crm/errors"
  }
}

HTTP Status Codes

CodeNameDescriptionRetry
400Bad RequestInvalid request parameters
401UnauthorizedMissing or invalid API key
403ForbiddenInsufficient permissions
404Not FoundResource does not exist
409ConflictDuplicate record
429Rate LimitedToo many requests
500Server ErrorInternal server error

Next Steps