Less boo. More booked. Halloween offer: 30 days free on any paid plan. Claim 30 days freeEvery new account gets one free mailbox for warmup and replies. No domain to buy. See how it works

Skip to content

bad_request

ReferenceErrors & Rate Limits

One of the error codes on Errors & Rate Limits.

The API returns bad_request with HTTP status 400.

Malformed request body/query, often paired with field errors in details.

Reference

#Where the API reference mentions it

Reference

#What the response looks like

json
{
  "error": {
    "code": "bad_request",
    "message": "...",
    "details": null
  }
}

error.code is stable and safe to branch on. error.message is debugging context, not something to parse. The full list of codes, and the rate limits, are on Errors & Rate Limits.

Was this page helpful?