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
| Code | Name | Description | Retry |
|---|---|---|---|
| 400 | Bad Request | Invalid request parameters | |
| 401 | Unauthorized | Missing or invalid API key | |
| 403 | Forbidden | Insufficient permissions | |
| 404 | Not Found | Resource does not exist | |
| 409 | Conflict | Duplicate record | |
| 429 | Rate Limited | Too many requests | |
| 500 | Server Error | Internal server error |