Skip to main content
POST
Create a commission

Authorizations

Authorization
string
header
required

Tolt API key sent as a bearer token.

Body

application/json

Send customer_id, or partner_id and program_id together when the commission has no customer. A request with neither returns 400.

amount
integer
required

What the partner earns for this commission, in minor units of the program currency (cents for USD).

Required range: -9007199254740991 <= x <= 9007199254740991
created_at
string<date-time>

When the commission was earned, as a timestamp with a time zone, for example 2026-03-01T12:00:00Z. Reports and filters by creation date place the commission on this date; the upcoming approvals forecast goes by its scheduled approval date, which this does not change. Defaults to now.

customer_id
string

Id of the customer the commission is for (cus_...), as returned when listing customers. The commission goes to the customer's partner and program; partner_id and program_id can be left out, and when given they must match the customer's.

Minimum string length: 1
partner_id
string

Id of the partner who earns the commission (part_...), as returned when listing partners. Used with program_id when no customer_id is given.

Minimum string length: 1
program_id
string

Id of the partner's program (prg_...). Required with partner_id when no customer_id is given.

Minimum string length: 1
revenue
integer

The sale amount the commission is based on, in minor units of the program currency.

Required range: -9007199254740991 <= x <= 9007199254740991
status
enum<string>
Available options:
pending,
approved,
rejected
source
string

Free-form label for where the commission came from, such as stripe or api.

Maximum string length: 255
charge_id
string

Id of the payment in your billing system that the commission is for, such as a Stripe charge id.

Maximum string length: 255
transaction_id
string

Id of the transaction the commission is for (txn_...). It must belong to the commission's customer, or to its partner and program, and must not be refunded.

Response

The created commission

success
boolean
required
Example:

true

message
string
required
Example:

"Request successful"

data
object
required