When calls fail
A failed call returns a standard status code and a brief note about what to fix.
Status codes
400Bad requestThe request body is not valid JSON, or it leaves out a required field.
401UnauthorizedNo key was sent, it has a typo, or it was revoked.
403ForbiddenThat action is not allowed for this key type. Use a full access key instead.
404Not foundWe cannot find that campaign, person or page on your account.
409ConflictThe item is in the wrong state for this, like trying to edit a draft that is already waiting for approval.
422Failed a checkA field did not pass a check, for instance a list with no consent source.
429Slow downYou sent too many requests. Wait as long as the Retry-After header says.
5xxOur sideThe problem is on DashStash’s side. Try again, waiting a little longer each time.
How a failure looks
{
"error": {
"code": "audience_not_found",
"message": "No audience with id aud_4d1x.",
"status": 404
}
}Rate limits
Your plan sets how often you can call. Go past that and you get a 429 with a Retry-After header, so a script can wait and carry on.
Want access? The API is available to early-access accounts. Email [email protected].