Skip to main content

Create Approval Delegation

POST 
/api/approval-delegations

Let someone approve on your behalf while you are away. During the window the delegate can act on every step you are eligible for; their decisions record on_behalf_of you. Pending requests are updated immediately.

Required scope: purchase-orders:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Authentication: Requires Bearer token with the purchase-orders scope (read for GET, write for POST/PUT/DELETE).

Body fields:

  • user_id (integer, optional, nullable) — who is delegating; defaults to you. Setting it for someone else requires administrator access (403 approval_delegation_forbidden).
  • delegate_user_id (integer, required) — a different user in this account
  • starts_at (datetime, required)
  • ends_at (datetime, required, after starts_at; at most 90 days later)
  • document_types (array, optional, nullable) — purchase_order, vendor_deposit, bill_payment; null or empty = all
  • notes (string, optional, max 500)

Returns 422 when the delegate is the delegator, either user is not in the account, the window is too long, or it overlaps an existing delegation for the same document types (revoke that one first).

Request​

Responses​

Created

Response Headers
    Content-Type