Common errors
Diagnose common request, auth, and limit failures.
Typical failures
- 401: missing or invalid authentication details
- 403: the key does not have the needed scope
- 404: the message ID does not exist in your accessible scope
- 413: the payload is too large
- 429: you are sending too fast
How errors are returned
homail uses stable machine-readable error codes, so your app can show a useful message or retry in a controlled way.