Guide

Errors

The HTTP status says what went wrong. The body says why, in one of these shapes:

  • a message: {"message": "Campaign not found"}, sometimes with "status": 0 or "status": "error";
  • the fields that failed, each with its messages: {"from_email": ["The from email must be a valid email address."]};
  • for the newer calls, both: {"message": "…", "errors": {"type": ["…"]}}.

Each call lists the statuses it answers with. The most common:

Status Meaning
400 The request misses something the call needs.
401 The token is missing or wrong, or its user may not act on this object.
403 The call refuses the request: a field is wrong, or the account may not do this.
404 Nothing has this uid or id.
409 The object is not in a state that allows the call (already subscribed, archived, …).
422 The request is well formed but refused; the message says why.
429 Too many calls; wait a minute.