PARTNER_ROLE_FORBIDDEN - Blujay API

HTTP status	Retryable
`403`	No

What happened

The partner key has the messaging role, which can read everything for a customer, read partner webhook subscriptions and their delivery log, and change chats, messages, contacts, attachments and vCards, but can’t create customers, add teammates, change or replay partner webhooks, or change other settings.

How to fix it

Use a partner key with the admin role for this request.

Example response

An illustrative example. The message wording and the contents of details vary; branch on error.code.

{
  "status": "error",
  "error": {
    "code": "PARTNER_ROLE_FORBIDDEN",
    "message": "Partner key role not allowed",
    "type": "authorization",
    "http_status": 403,
    "retryable": false,
    "doc_url": "https://docs.blujay.io/errors/partner-role-forbidden",
    "details": []
  },
  "trace_id": "trc_8f2a1c0e4b7d",
  "timestamp": "2026-10-14T17:30:48.000Z"
}

Still stuck?

Email support@blujay.io with the trace_id from the error response. See Errors for the response format.