Errors

forbidden

403 Forbidden. The key is valid but may not do this.

Open in Claude Open in ChatGPT .md

Status	Code	Retry?
403 Forbidden	`forbidden`	No

What it means

The key is valid but may not do this.

Common causes

A webhook made by one key is changed with another key.
The action is only for the account owner in the dashboard.

What to do

This key or sign-in may not do that.

Can I retry it?

No. The same request gets the same answer however often it is sent, so change the request rather than repeating it.

What the answer looks like

Response403

{
  "error": {
    "code": "forbidden",
    "message": "This key may not change that webhook.",
    "hint": "This key or sign-in may not do that.",
    "doc_url": "https://usebluebot.com/docs/errors/forbidden",
    "request_id": "req_1Hq2LxW9cVbN3mKpRtYs0a"
  }
}

Branch on code, which never changes. message and hint are written for people and may be reworded. Quote request_id when you write to support.

Errors: the envelope and every code
Idempotency: retrying without sending twice
Limits: every cap and what happens when you reach it