Error Handling

The Emailhook API uses conventional HTTP response codes.

HTTP Status Codes

Code	Description
200	OK - Request succeeded
201	Created - Resource created successfully
204	No Content - Request succeeded, no content returned
400	Bad Request - Invalid request parameters
401	Unauthorized - Invalid or missing API key
404	Not Found - Resource doesn't exist
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error - Server error

Error Response Format

All error responses follow the same structure:

{
  "error": {
    "type": "error_type",
    "message": "Human-readable error message",
    "requestId": "req_abc123"
  }
}