Send a one-time payout
send a wallet-funded, arbitrary-amount one-time payout to a creator. Requires the payouts:write scope.
Authorizations
OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.
Headers
Client-chosen key; replaying the same key + body returns the original response, a different body returns 409.
Body
Send a wallet-funded, arbitrary-amount one-time payout to a creator. Moves real money from the company wallet.
The creator id to pay.
Payout amount in USD dollars (e.g. 50 = $50.00). Must be positive and not exceed $10,000.
x <= 10000Required description of the commercial obligation and completed work.
10 - 500Optional campaign (program) id to attribute the payout to.
Optional context to mark a specific post as excluded after the payout. The company is always the token tenant; any companyId in this object is overridden server-side.
Response
The one-time payout was sent.
Result of a one-time payout. Amounts marked USD are dollars; amounts marked Cents are integer cents.