# PATCH /agency/team-commission/plans/:user_id

**Resource:** [Agency](./agency.md)  
**MCP tool:** `update_agency_team_commission_plan`  
**Scopes:** `agency:write`  
**Write operation:** yes

Agency owner only: set or change one salesperson's commission plan. Rates are percentages (10 = 10%, up to 100). Anything left out keeps its current value. Example, 100% of the first month then 10% of everything: one_off_percent 10, first_months 1, first_months_percent 100, ongoing_percent 10, ongoing_forever true. Every finished month is locked in at the old plan first, so a change applies from this month on; a person's first plan also covers the months since they joined.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `user_id` | path | string | yes | The salesperson (people[].user_id from get_agency_team_commission) |
| `one_off_percent` | body | number | no | Percent of one-off fees (setup fees, Website Design, AI Agents), 0 to 100 |
| `first_months` | body | number | no | How many of the client's first paid months get first_months_percent (0 for none) |
| `first_months_percent` | body | number | no | Percent of the subscription in those first months, 0 to 100 |
| `ongoing_percent` | body | number | no | Percent of the subscription after the first months, 0 to 100 |
| `ongoing_months` | body | number | no | How many months ongoing_percent lasts after the first months, then it stops. For as long as the client stays, send ongoing_forever true instead. |
| `ongoing_forever` | body | boolean | no | true: ongoing_percent lasts as long as the client stays (clears ongoing_months) |
| `require_approval` | body | boolean | no | Optional. Set true to route this write into the approval queue for human review instead of executing it immediately (returns 202 + an approval_id). Works even when your key/token has permission to execute directly. |

## Request example

```bash
curl -X PATCH   "https://api.trustpager.com/functions/v1/api/v1/agency/team-commission/plans/:user_id"   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"one_off_percent":"...","first_months":"...","first_months_percent":"..."}'
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`