Guide
Errors
The error envelope, status codes and numbered errors.
Refused requests answer with HTTP 400 and one of two shapes:
{ "status": "error", "message": "Validation error", "details": { "messages": [ { "message": "name is required" } ] } }{ "status": "error", "message": "The contact's 24-hour window is closed.", "code": 3011 }Numbered errors
| Code | Where | What it means |
|---|---|---|
| 3011 | sendContent | The contact's messaging window is closed and no allowed message tag was given. |
| 3021 | sendContent | The contact has no one-time notification token for the chosen topic. |
| 3040-3049 | sendContent, sendContentByUserRef | The content can't go to this contact on this channel (not connected, opted out, or not on any channel). |
| 2011 | user_ref operations | The user_ref isn't registered. |
| 2012 | user_ref operations | The user_ref exists but isn't linked to a contact yet. |
Other statuses
401 a missing or wrong key, 404 an unknown path, 405 the wrong method, 429 over a limit, 500 our fault. All use the first error shape. Something that doesn't exist (a contact id, a tag) answers 400 with a message saying so.