> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blujay.io/llms.txt
> Use this file to discover all available pages before exploring further.

# PARTNER_ROLE_FORBIDDEN

> Partner key role not allowed

| 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`.

```json theme={null}
{
  "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](mailto:support@blujay.io) with the `trace_id` from the error response. See [Errors](https://docs.blujay.io/errors.md) for the response format.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.