Nothing to turn on
Commissions are on in every workspace. There is no switch to flip first: create a plan 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 that has no split of its own: the primary owner (the default) or the owners evenly. See Splitting a deal’s commission.
- Primary owners can split their deal’s commission: on by default.
- Who sees what, with a link to the roles.
Who sees what
A manager is anyone set as someone’s Reports to in Settings → Team members. A deal’s primary owner can also split its commission 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.
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.
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.
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).”
- Rules: who gets credit for a deal, when a deal counts, the clawback window and a cap.
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.
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, 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:
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.
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.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 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:
Only The deal’s split reads the split set on a deal. The other rules ignore it, but a custom commission 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%.
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.
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, 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.
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 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:readto read,commissions:writeto 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
409withcommissions_off.
/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:
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.