OAUTH_SCOPE_REQUIRED

HTTP status	Retryable
`403`	No

What happened

The request used a connected app’s access token that doesn’t include the permission this endpoint needs.

How to fix it

If you’re calling the API yourself, use your workspace API key. If this came from a connected app, reconnect it in Blujay so it asks for the permission it needs; error.details names it.

Example response

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

{
  "status": "error",
  "error": {
    "code": "OAUTH_SCOPE_REQUIRED",
    "message": "OAuth scope required",
    "type": "authorization",
    "http_status": 403,
    "retryable": false,
    "doc_url": "https://docs.blujay.io/errors/oauth-scope-required",
    "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.

Overview

Request errors

Authentication

Idempotency

Rate limits and capacity

Sending messages

Chats and groups

Edit and unsend

Media

Contacts

Workflows

Webhooks

Server and availability

OAUTH_SCOPE_REQUIRED

What happened

How to fix it

Example response

Still stuck?

​What happened

​How to fix it

​Example response

​Still stuck?

What happened

How to fix it

Example response

Still stuck?