403

API problem detail

Forbidden

Description

This problem happens when your token is valid but is not allowed to perform the action. Common causes:

  • The integration was not granted the scope the endpoint needs (for example a write scope for a create or an action).
  • The user named in the request (requester, approver, or actor) lacks the branch or bank-account permission for the action.
  • The token's company or user context is missing, malformed, or belongs to another company.
  • The company does not have the required product enabled, for example a granular POST /Disbursement without Business disbursements.

Response errorCode: PERMISSION_DENIED.

Experience API error bodies also carry errorCode, resolution, and traceId. Branch on errorCode, not on title or detail; see fields on every error.

How to resolve

Check the integration's granted scopes and the named user's current permissions with a company administrator, then repeat the request. Retrying unchanged returns the same 403.
Back to all problem details