Skip to main content
POST
Create an approval request

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Headers

Idempotency-Key
string

Client-chosen key; replaying the same key + body returns the original response, a different body returns 409.

Body

application/json

Create a pending approval request. companyId is the token's tenant, never the body.

recipients
object[]
required
Minimum array length: 1
totalAmount
number

Optional explicit total; when absent or not a positive number it is computed from the recipients' line items.

Response

The created pending approval request.

data
object
required