Contents

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

CodeWhereWhat it means
3011sendContentThe contact's messaging window is closed and no allowed message tag was given.
3021sendContentThe contact has no one-time notification token for the chosen topic.
3040-3049sendContent, sendContentByUserRefThe content can't go to this contact on this channel (not connected, opted out, or not on any channel).
2011user_ref operationsThe user_ref isn't registered.
2012user_ref operationsThe 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.

Next: Webhooks