> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useorbitcrm.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Commissions

> Pay your team from the deals, meetings and calls already in Orbit: a plan from a template, live statements for every rep, approvals and payouts.

Commissions turns the deals your team wins, and the meetings and calls they book, into what each person has earned. Build a plan once, from a template. From then on every rep sees their earnings update as deals close, managers approve each period's statements, and you export the payouts for payroll.

| Word | What it means |
| - | - |
| **Plan** | A set of rules for one role: a period (month, quarter or year), quotas and the ways people earn. |
| **Quota** | A target per period: won amount, deals, meetings, calls. |
| **How they earn** | The ways a plan pays: a rate on deals, a fixed amount per meeting, a bonus, objectives, a manager override. A plan can have several. |
| **Statement** | One person's earnings on one plan for one period. |
| **Payable** | What to pay for a period: what was earned and is due now, plus releases, clawbacks, adjustments and draws. |

## Nothing to turn on

Commissions are on in every workspace. There is no switch to flip first: [create a plan](#set-up-a-plan-in-five-minutes) and put people on it. Until then nothing is calculated. **Commissions** shows in the menu only for people with something to see there: admins, the workspace owner and anyone whose role has **Manage commissions** or **View all commissions**, then managers of people, and each person once they are on a plan.

The first plan you create asks for your **time zone**. The other settings start with sensible defaults, and you can change them any time in **Settings → Commissions**:

* **Approvals**: on by default. Statements are approved, then paid. Turn it off to lock a statement when you mark it paid.
* **Time zone**: the time zone periods and earn dates follow. A deal won at 11 pm on the 31st counts in the month it was won there.
* **Deals with co-owners**: who earns on a deal with [co-owners](https://docs.useorbitcrm.ai/guides/multiple-owners.md) that has no split of its own: the primary owner (the default) or the owners evenly. See [Splitting a deal's commission](#on-the-deal-page).
* **Primary owners can split their deal's commission**: on by default.
* Who sees what, with a link to the roles.

Not paying commission from Orbit? **Turn off commissions** at the foot of **Settings → Commissions** hides the page and menu item for everyone and stops the calculations. Plans and statements are kept, and **Turn commissions back on** on the same page picks up where you left off.

## Who sees what

| Who | Sees | Can |
| - | - | - |
| Someone on a plan | Their own statements | Dispute a line on them |
| A manager | Their own, and the statements of everyone who reports to them, directly or through others | Only read their reports' statements |
| **View all commissions** | Everyone's statements | Only read them |
| **Manage commissions** | Everyone's statements | Build plans and put people on them, approve, mark paid, reopen, add adjustments, score objectives, resolve disputes, split any deal's commission and give custom commissions, change the settings, turn commissions off or back on |
| The workspace owner | Everything | Everything |

A manager is anyone set as someone's **Reports to** in **Settings → Team members**. A deal's primary owner can also [split its commission](#on-the-deal-page) between the deal's owners, while **Primary owners can split their deal's commission** is on.

The built-in Admin role has both permissions. Editor and Viewer have neither. To give them to someone else, create a role in **Settings → Team members → Roles** and tick them under **Commissions**. **Manage commissions** needs **View all commissions**, and a role based on Viewer can have **View all commissions** only.

> [!NOTE]
>
> Commissions follow these rules, not record access. A manager approving a statement sees the names of the deals behind it, even deals they cannot open.

The **Commissions** page has a tab for each: **My commissions** for anyone on a plan, **Team** for managers and **View all commissions**, and **Payouts** and **Plans** for **Manage commissions**.

## Set up a plan in five minutes

**1. Pick a template**

Go to **Commissions** and choose **Create your first plan** (later: **Plans → New plan**), then pick the template closest to how you pay today (see the list below). Every number in it can be changed. The first time, check the **time zone** at the top: periods and the day a deal counts on follow it.

**2. Name it and choose the period**

Give it a name, then choose **Monthly**, **Quarterly** or **Yearly** and the date it starts. Quarters and years follow your fiscal year (**Settings → Deals → Fiscal year starts in**).

**3. Add the people**

Under **Who's on it**, add the people the plan is for. Each one gets the plan's quota, or a quota of their own.

**4. Check the example**

The live example beside the plan shows what a rep would earn. Drag the attainment slider to see a slow month and a great one.

**5. Make it Active**

Set the status to **Active**. A **Draft** plan earns nothing, so you can set it up without anyone seeing numbers that aren't final.

Everyone on the plan now sees their earnings on **My commissions**, and you see the whole team on **Team**.

| For | Templates |
| - | - |
| Account executive | Flat rate · Accelerators · Accelerators and decelerators · Cliff · Capped · Milestone bonus · Contract term multiplier |
| SDR | Meetings booked · Meetings booked on a live call · Live calls · Meetings held · Qualified opportunity plus closed-won |
| Account manager | Renewals and expansion |
| Sales manager | Team roll-up · Team override |
| Any role | SPIFF · Blank |

## How a plan is put together

A plan page has four parts:

* **Who's on it**: the people, from a start date, each with their own quota, rates or draw when they differ from the plan.
* **Quota**: what counts and how much per period. A plan can have several quotas, for example revenue and meetings.
* **How they earn**: each way to earn as a card that reads as a sentence: "Pays 10% of amount on won deals, 15% past 100% of the Revenue quota." or "\$50 per meeting booked (counted for whoever booked it)."&#x20;
* **Rules**: who gets credit for a deal, when a deal counts, the clawback window and a cap.

A plan is **Draft** (being set up, earns nothing), **Active** or **Archived** (kept for history, earns nothing new). Changing a plan updates open statements at once. Approved and paid statements never change: one that would now come out differently shows a [correction](#corrections).

A deal counts on the day it was won, or on a date field you choose, such as **Invoice paid on**. Deals are taken in that order, so the deal that crosses into a higher tier is the same one every time you look.

## Ways to pay

Each structure below has a worked example. Most plans combine two or three of them.

### Flat rate

One rate on every won deal. It is the simplest plan to explain and to check.

**Example:** 10% of amount. A \$50,000 deal pays \$50,000 × 10% = **\$5,000**.

### Tiers: marginal or retroactive

A rate table pays more as attainment grows. With **marginal** tiers (the default), each part of a deal earns the rate of the tier it falls in. With **retroactive** tiers, reaching a tier pays every deal in the period at that tier's rate, so the earlier deals are paid again at the higher rate.

**Example (marginal):** a \$100,000 quota, 10% up to 100% and 15% above. A rep at \$90,000 wins a \$15,000 deal. \$10,000 of it is below quota and \$5,000 above, so it pays \$10,000 × 10% + \$5,000 × 15% = **\$1,750**.

**Example (retroactive):** 6% up to 100%, 12% above, and \$120,000 won against a \$100,000 quota. Retroactive pays \$120,000 × 12% = **\$14,400**. The same table, marginal, pays \$6,000 + \$2,400 = \$8,400.

### Accelerators and decelerators

An accelerator is a higher rate past quota. A decelerator is a lower rate below a point, so a slow period earns less per dollar than a good one.

**Example:** a \$1,000,000 quota, 5% up to 50%, 10% up to 100%, 15% above. \$1,200,000 won pays \$500,000 × 5% + \$500,000 × 10% + \$200,000 × 15% = \$25,000 + \$50,000 + \$30,000 = **\$105,000**.

### Cliffs and hurdles

A **cliff** pays nothing until a quota reaches a threshold, then pays everything in the period, deals before the threshold included. A **hurdle** pays only what comes after the threshold.

**Example (cliff):** 10% of amount, nothing below 60% of a \$100,000 quota. \$55,000 won pays **\$0**. \$60,000 won pays **\$6,000**.

**Example (hurdle):** 10% of amount, nothing below 50% of a \$100,000 quota. Deals of \$40,000, \$20,000 and \$5,000 pay \$0, \$1,000 (10% of the \$10,000 past \$50,000) and \$500: **\$1,500**.

### Bands by deal size

Tiers can apply to each deal on its own instead of the period's total. Bigger deals then earn a higher rate on their top part, however the rest of the period went.

**Example:** 10% on the first \$25,000 of a deal and 12% above. A \$40,000 deal pays \$25,000 × 10% + \$15,000 × 12% = \$2,500 + \$1,800 = **\$4,300**. A \$10,000 deal after it starts again at the first band and pays \$1,000.

### Caps

Cap what one deal can pay, what one way to earn pays a person in a period, or what the whole plan pays a person in a period. The statement shows every deal's full amount and a cap line for what the cap took off, so the working stays visible. A cap can also be a last tier at 0%.

**Example (a cap per period):** 10% of amount, at most \$2,500 a quarter. Three \$10,000 deals earn \$1,000 each. The third is cut to \$500, and a cap line shows the \$500 over: **\$2,500**.

**Example (a 0% tier):** 10% up to 200% of a \$100,000 quota, then 0%. Deals of \$150,000 and \$100,000 pay \$15,000 and \$5,000: **\$20,000**. The last \$50,000 earns nothing.

### Multipliers

A multiplier changes what a deal pays when a field on it matches, such as a longer contract term or a partner-sourced deal. When several match, they multiply. A cap per deal applies after them.

**Example (the Contract term multiplier template):** 10% of amount, 1.25x for 24-month contracts and 1.5x for 36 months or more. Two \$10,000 deals, on 24 and 36 months, pay \$1,250 + \$1,500 = **\$2,750**.

**Example (stacked, with a cap per deal):** 10% of amount, 1.25x for a contract of 24 months or more, 1.2x for a partner deal, and at most \$2,000 per deal. A \$10,000 partner deal on a 36-month contract pays \$1,000 × 1.25 × 1.2 = **\$1,500**. A \$20,000 deal on a 24-month contract would pay \$2,500 and is capped at **\$2,000**.

### What a deal is worth

A quota or a rate can count a deal by:

* **Amount**: the deal amount (the default).
* **ARR** or **MRR**: the deal's recurring amount, per year or per month.
* **Line items**: the sum of its line items, all of them or only some products, recurring or one-time.
* **A number field**: any number or currency field on the deal.

The quota and the rate can count different things, for example ARR toward quota while paying on the first year's amount. Amounts are in your workspace currency, converted at the deal's own rate. A deal whose amount can't be converted earns nothing on amount and the statement names it.

**Example:** 10% of ARR. A deal with \$1,000 a month of recurring revenue is worth \$12,000 a year and pays **\$1,200**. Paid on MRR, it is worth \$1,000.

### Which deals count

Every quota and way to earn can be limited to some deals: pipelines, deal types (new business, renewal, expansion), products, teams, products on the line items, a minimum value, and tests on any deal field (is, is not, at least, at most, is set, is not set). Every test must pass; a test with several values matches any of them.

**Example (the Renewals and expansion template):** 5% of renewals and 10% of expansion deals. A \$10,000 renewal and a \$10,000 expansion pay \$500 + \$1,000 = **\$1,500**. A new-business deal pays nothing on this plan.

Ways to earn can also share one quota, so every kind of deal moves the rep toward their accelerator.

**Example (a shared quota):** new business at 10% (20% past quota) and renewals at 5%, sharing a \$100,000 revenue quota. A \$100,000 renewal pays \$5,000 and brings the rep to quota, so a \$10,000 new-business deal after it pays 20%: **\$2,000**.

### Plans per product

In a workspace with [several products](https://docs.useorbitcrm.ai/guides/multi-product-setup.md), a plan can be for some products only. Its quotas and ways to earn then count only the deals and activity on those products' teams. One plan can also pay different rates per product, with a way to earn for each.

**Example:** one plan for Product A and Product B, paying 10% on Product A deals and 15% on Product B deals. A \$1,000 deal on each pays \$100 + \$150 = **\$250**. A deal on neither product's team counts for nothing, not even toward quota.

### Fixed amounts per deal

Pay a set amount for each deal instead of a percentage, for example per new logo. It can step up past a number of deals or a quota. A rep with part of a deal's credit gets that part of the amount.

**Example:** \$500 per deal won of \$5,000 or more. A \$6,000 deal credited half to the rep pays them **\$250**. A \$4,000 deal pays nothing.

### SDR pay for meetings and calls

Pay a fixed amount for each piece of activity, optionally more past a count or a quota:

| Activity | What counts | Credited to |
| - | - | - |
| **Meeting booked** | A meeting booked, on the day it was booked. Cancelled meetings don't count. | Whoever booked it, otherwise the host |
| **Meeting booked on a live call** | A dialer call logged with the outcome **Meeting booked** | The caller |
| **Live call** | A dialer call with an outcome that counts as reaching a person, optionally at least a set length or only some outcomes | The caller |
| **Call** | Every outbound dialer call | The caller |
| **Meeting held** | A meeting marked completed (not a no-show), on the day it took place | The host, or whoever booked it |
| **Deal created** | A deal created, optionally only some deals (new business, say) | Whoever created it, or its owner |
| **Deal won** | A deal won | As the plan credits deals |

Meetings can also be limited to some scheduling pages, and any activity to some products. Which call outcomes count as reaching a person is set under **Settings → Dialer**, with the **Reached** switch on each outcome.

**Example (per meeting booked):** \$50 per meeting booked. Two meetings the rep booked pay **\$100**. A meeting someone else booked for them doesn't count for them, unless the plan pays the host.

**Example (booked on a live call):** \$40 per meeting booked on a live call. A call logged **Meeting booked** pays **\$40**; a live call with another outcome pays nothing.

**Example (per live call):** \$5 per live call of at least 60 seconds. Live calls of 60 seconds, 59 seconds and 5 minutes pay **\$10**: the 59-second call is too short. A call that reached no one never counts.

**Example (more past a count):** \$100 per meeting held up to 20, \$150 after. 22 meetings held pay 20 × \$100 + 2 × \$150 = **\$2,300**.

**Example (more past quota):** \$50 per meeting booked, \$75 past 100% of a 20-meeting quota. 23 meetings pay 20 × \$50 + 3 × \$75 = **\$1,225**. Retroactive, all 23 pay \$75: \$1,725.

> [!TIP]
>
> **Meeting booked** counts meetings on the calendar. **Meeting booked on a live call** counts calls logged with the outcome **Meeting booked**. If a plan pays for both, a meeting set on a call can count twice, so most SDR plans pay for one of them.

### Target and milestone bonuses

A **target bonus** pays a set amount at 100% of quota, in proportion to attainment, and can speed up past a point. A **milestone bonus** pays fixed amounts when attainment reaches thresholds; they add up, and nothing is paid for partial progress.

**Example (target):** a \$1,000 bonus on a \$10,000 monthly quota. 60% attainment pays **\$600**. With 1.5x past 100%, 110% pays \$1,000 + \$100 × 1.5 = **\$1,150**.

**Example (milestone):** \$5,000 at 100% and \$1,000 more at 110%. 90% pays nothing, 105% pays **\$5,000** and 112% pays **\$6,000**.

### SPIFFs

Any way to earn can have a start and an end date. It then pays only on what is earned between them: a short contest on top of the regular plan.

**Example (the SPIFF template):** \$500 for every new-business deal won between two dates. A new-business deal and a renewal won during it pay **\$500**.

**Example (the dates):** an extra 10% on deals won in November. \$1,000 deals won on November 1 and November 30 pay \$100 each. Deals won on October 31 and December 1 get nothing from it.

### Objectives (MBOs)

Split a target amount over objectives with weights. Each period a manager scores each objective from 0 to 100% (or higher, if you set a higher top score). The bonus is the target amount times the weighted score. An objective that isn't scored counts as 0.

**Example:** a \$5,000 target over two objectives of equal weight. **Hire an SDR** scores 100% and **Build pipeline** 70%. The weighted score is 85%, which pays **\$4,250**.

### Manager roll-ups and overrides

A **roll-up** pays a manager on their team's results: any rate, fixed amount, bonus or quota can count the deals and activity of everyone who reports to them (and of teams you choose), with or without their own. An **override** pays a percentage of what their reports earned in commission.

**Example (roll-up):** 3% of the team's won amount, 5% past 100% of a \$100,000 team quota. Ann wins \$80,000 and Bob \$40,000: \$80,000 × 3% + (\$20,000 × 3% + \$20,000 × 5%) = \$2,400 + \$1,600 = **\$4,000**. The manager's own deals don't count unless the roll-up includes them.

**Example (override):** 10% of the team's commission. The manager's reports earned \$42,000 this period, so the override pays **\$4,200**.

### Draws

A draw pays at least a set amount each period. A **non-recoverable** draw is a guarantee: if earnings fall short, the difference is topped up and never paid back. A **recoverable** draw tops up the same way, but the top-ups are a balance, paid back from later periods that earn more than the draw.

**Example (non-recoverable):** a \$5,000 draw and \$3,200 earned. The statement adds a \$1,800 top-up and pays **\$5,000**.

**Example (recoverable):** a \$5,000 draw over four months.

| Month | Earned | Top-up or paid back | Paid | Still owed |
| - | - | - | - | - |
| 1 | \$3,200 | +\$1,800 | \$5,000 | \$1,800 |
| 2 | \$2,000 | +\$3,000 | \$5,000 | \$4,800 |
| 3 | \$8,000 | −\$3,000 | \$5,000 | \$1,800 |
| 4 | \$7,000 | −\$1,800 | \$5,200 | \$0 |

### Ramps and per-person quotas

Anyone on a plan can have their own quota, rates, bonus amount or draw. A **ramp** sets their quota for given periods, so a new hire's target grows over their first months. A person's first period counts as a whole period, even if they joined partway through it.

**Example:** a \$50,000 monthly quota, ramped to \$0 in month one, \$12,500 in month two and \$25,000 in month three. \$12,500 won is 100% of quota in month two, 50% in month three and 25% from month four, on the full \$50,000.

### Quotas from Goals

A quota can take each person's target from **Analytics → Goals** when they have one for the period: won amount from **Revenue won**, deals from **Deals won**, calls from **Calls** and meetings from **Meetings**. Without a goal it uses their own quota on the plan, then the plan's. A [ramp](#ramps-and-per-person-quotas) target for that period still comes first.

**Example:** the plan's quota is \$100,000 and Alice's own is \$80,000. With a \$90,000 goal for the quarter, her quota is **\$90,000**. Without a goal, it is \$80,000.

A quota can also be **cumulative**: attainment adds up across the plan year, so a slow month can be made up the next.

**Example (cumulative):** a \$50,000 monthly quota. \$40,000 in January is 80%. \$70,000 more in February makes \$110,000 against \$100,000: **110%**. \$10,000 more in March makes \$120,000 against \$150,000: 80%.

### Who gets credit for a deal

A plan's credit rule says whose statement a won deal goes on:

| Rule | Who earns on a won deal |
| - | - |
| **The deal's split** (the default) | Whoever the deal's [commission split](#on-the-deal-page) names. A deal without one uses its **Splits** when deal splits are on (**Settings → Deals**), and otherwise the workspace default: its primary owner, or its owners evenly. |
| **Primary owner** | The primary owner only. |
| **Every owner** | The primary owner and every [co-owner](https://docs.useorbitcrm.ai/guides/multiple-owners.md), each with full credit. |
| **Owners share** | The owners share it evenly. |
| **Everyone on the plan** | Every person on the plan, with full credit, for every deal the plan counts: overlay roles such as solutions engineers. |

Only **The deal's split** reads the split set on a deal. The other rules ignore it, but a [custom commission](#custom-commissions) on a deal is paid whatever the rule. A rep's share counts toward their quota as well as their pay.

**Example:** 10% of amount, a \$30,000 deal owned by Alice with Ben as co-owner. **Primary owner** pays Alice \$3,000. **Every owner** pays Alice and Ben \$3,000 each. **Owners share** pays each of them 10% of \$15,000: **\$1,500**.

## Statements and payouts

Each person on a plan has one statement per period. It lists each quota with attainment, each deal and activity with what it paid and how ("\$50,000 × 10% = \$5,000"), and what is still needed for the next tier.

**Example:** 10% up to a \$100,000 quota and 12% above. At \$88,000, the statement says **\$12,000 more to reach 12%**.

| Status | What it means |
| - | - |
| **Open** | Calculated live. It changes as deals close and as the plan changes. |
| **Approved** | Locked. It stays as approved even if the deals behind it change. |
| **Paid** | Locked and paid, with the date and a note such as the payroll reference. |

On **Team**, select statements and click **Approve**, then **Mark paid** once payroll has run. With **Approvals** off, **Mark paid** locks a statement in one step. **Reopen** unlocks an approved statement that hasn't been paid; a paid statement never reopens. The rep is notified when their statement is approved and when it is paid.

What is payable for a period is what was earned and is due now, plus held amounts released this period, clawbacks, adjustments and corrections. The draw comes last.

### Holdbacks and paying on cash collected

A way to earn can pay in steps: part when the deal is earned, part a number of days later, or part when a date field on the deal is set, such as **Payment received**. Held amounts show on the statement with when they will be released, and appear as a release line in the period they become payable.

To pay only once the customer has paid, there are two ways:

* **Count the deal on the payment date** (a rule on the plan). The deal then counts toward quota in the period the customer paid in.
* **Hold the payout until the date is set.** The deal counts toward quota in the period it was won, and its commission is paid once the date is filled in.

**Example (days later):** a quarterly plan paying half when earned and half 90 days later. \$1,000 earned on October 1 is all payable on the October to December statement, because the 90 days end on December 30. \$1,000 earned on October 15 pays **\$500** now and holds \$500 until January 13, in the next quarter.

**Example (cash collected):** 10%, half when earned and half once **Invoice paid** is set. Three \$10,000 deals earn \$1,000 each. The one already paid pays \$1,000; the other two pay \$500 each now and hold \$500 until the date is filled in: **\$2,000** now and \$1,000 held.

### Clawbacks

Set a clawback window on the plan, for example 90 days. If a deal on an approved or paid statement is lost, reopened or deleted within that many days of being earned, what it paid is taken back in the current period as a negative line. It is taken back once. Outside the window, the commission stands.

**Example:** a deal paid \$400 on July's statement and was lost 20 days after it was won, inside a 90-day window. The current statement gets a line "Lost deal (taken back)" of **−\$400**.

### Corrections

If an approved or paid statement would now come out differently, because a deal's amount was edited or the plan changed, it shows a correction with the difference. **Apply** adds the difference to the current period. **Keep** keeps the approved amount and hides the correction.

### Adjustments

**Add adjustment** on a statement adds a one-off amount, positive or negative, with a note: a spot bonus, a manual split, a payroll fix.

### Disputes

A rep who thinks a line is wrong clicks **Dispute** on it and says why ("this deal should have paid 12%"). People with **Manage commissions** are notified, and one of them answers with **Resolve**.

### Payouts

The **Payouts** tab lists approved statements waiting to be paid and the paid history. **Export CSV** downloads the period's approved and paid statements for payroll.

## On the deal page

A **Commission** card on each deal shows who earns what on it, for the people whose commissions you can see. On a won deal it shows what each person earned. On an open deal it estimates what they would earn if it were won today: "If it's won this quarter, Alice earns about \$1,200."

### Splitting a deal's commission

By default, a deal's primary owner earns its commission. To share it with the deal's [co-owners](https://docs.useorbitcrm.ai/guides/multiple-owners.md), choose on the **Commission** card:

* **Primary owner**: the primary owner earns it all.
* **Split evenly**: the deal's owners share it evenly. Adding or removing a co-owner splits it again.
* **Custom split**: a percentage for each owner, adding up to exactly 100%. Owners left out get nothing.

A deal you haven't split uses the workspace default, **Deals with co-owners** in **Settings → Commissions**: the primary owner, or the owners evenly. If the deal has **Splits** (deal splits, **Settings → Deals**), those come before the default.

**Example:** a \$30,000 deal on a 10% plan, Alice primary owner and Ben co-owner, set to **Split evenly**. Each gets half: 10% of \$15,000 is **\$1,500** each, and each \$15,000 share counts toward their own quota. With a **Custom split**, each owner's percentage works the same way.

Split evenly between three owners gives 33.34%, 33.33% and 33.33%: the first owners take the leftover hundredth.

> [!NOTE]
>
> **Deal splits** and the commission split are different. Deal splits share a deal's credit between any people, in reports and goals. The commission split shares only its commission, only between its owners. When a deal has both, the commission split decides commissions.

### Custom commissions

People with **Manage commissions** can also give one of the deal's owners a **custom commission** on it, instead of what their plan pays on that deal: a fixed amount, or a percentage of the deal's whole amount (not of their share). Their share still counts toward their quota.

**Example:** Ben has half of a \$40,000 deal and a custom commission of 5%. He is paid 5% of the whole \$40,000, **\$2,000**, instead of what his plan pays on it, and his \$20,000 share still counts toward his quota. A fixed custom commission of \$2,000 would pay the same.

A custom commission is paid once, even if the person is on several plans. Someone on no active plan can't be paid until they are added to one, and the card says so.

### Who can change it

* **The primary owner** can change the split (not custom commissions) while **Primary owners can split their deal's commission** is on in **Settings → Commissions**. It is on by default.
* **People with Manage commissions** can change everything, custom commissions included.
* Everyone who can see the deal's commission sees how it is split.

### When the deal changes

* **An owner leaves the deal.** If the split, or a custom commission, names someone who no longer owns the deal, the deal goes back to the workspace default until someone updates it. The card says "The split names people who no longer own this deal".
* **A co-owner joins the deal.** **Split evenly** includes them at once. A **Custom split** stays as it is, so they earn nothing on the deal until someone gives them a share.
* **After approval.** Changing the split of a deal on an approved or paid statement shows as a [correction](#corrections) on that statement, like any other change.

## With the API and MCP

Everything above can be read and set up by your own code or an AI agent, with the same answers people get in the app.

* **Scopes:** `commissions:read` to read, `commissions:write` to change anything.
* **Access:** a key acts as the person who owns it. It reads only the statements that person could see, and changes need **Manage commissions** as well, except disputing a line on your own statement, and splitting the commission of a deal you are the primary owner of while the workspace lets primary owners do that.
* **On by default:** there is nothing to turn on. In a workspace that turned commissions off, everything but the settings answers `409` with `commissions_off`.

The API covers settings, plans and the people on them, templates, a preview of a plan on example numbers, statements (list, one person's, approve, mark paid, reopen), corrections, adjustments, objective scores, disputes and a deal's commission, under `/api/v1/commissions`. A deal's split is `GET` and `PUT /api/v1/commissions/deals/{id}/split`: `mode` (`primary`, `even` or `custom`), `shares` (each owner's percent, for `custom`) and `custom_pay` (an owner's fixed `amount` or `rate`).

Over [MCP](https://docs.useorbitcrm.ai/mcp/tools.md):

| Area | Tools |
| - | - |
| Settings | `get_commission_settings`, `update_commission_settings` |
| Plans | `get_commission_schema` (the plan format, units and templates), `list_commission_plans`, `save_commission_plan`, `archive_commission_plan`, `set_commission_plan_members` |
| Statements | `preview_commission_plan`, `list_commission_statements`, `get_commission_statement`, `update_commission_statements` (approve, mark paid, reopen), `apply_commission_correction` (add a correction to the current period, or keep the approved amount) |
| Adjustments and disputes | `add_commission_adjustment`, `delete_commission_adjustment`, `set_commission_mbo_scores`, `list_commission_disputes`, `resolve_commission_dispute` (raise, resolve or reopen a dispute) |
| Deals | `get_deal_commission` (who earns what on a deal, and its split), `set_deal_commission_split` |

Ask an agent "set up a plan for our SDRs: \$50 per meeting booked, \$75 past 20 meetings a month" and it builds the plan from the same parts the plan builder uses.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.