# Submit a pending employee contribution change request

**POST /employers/{employer_id}/employees/{employee_id}/contribution_change_requests**

Submit a pending employee contribution change request (mirrors the Penfold member
app flow). There is no separate read endpoint — poll `GET .../employees/{employee_id}`
for current contribution percentages. Emits a `ContributionChangeRequest` webhook
with action `Created` on success.



## Servers
- https://payroll-api.getpenfold.dev/v4: https://payroll-api.getpenfold.dev/v4 ()


## Authentication methods
- O auth2 client credentials


## Parameters

### Path parameters

- **employer_id** (string)

- **employee_id** (string)



### Body: application/json (object)

- **employee_contributions_percent** (number)
  Requested employee contribution percentage (0–100).

- **salary_sacrifice_enabled** (boolean)
  When `true`, request salary sacrifice opt-in.



## Responses
### 201
Contribution change request created.

#### Body: application/json (object)
- **id** (string)
  Unique identifier for the contribution change request.

- **employee_contributions_percent_from** (number | null)
  Previous employee contribution percentage, when the percentage changes.

- **employee_contributions_percent_to** (number | null)
  Requested employee contribution percentage, when the percentage changes.

- **salary_sacrifice_enabled** (boolean | null)
  `true` when salary sacrifice opt-in was requested.

- **created_at** (string(date-time))
  When the request was created (ISO 8601 UTC).

- **updated_at** (string(date-time))
  When the request was last updated (ISO 8601 UTC).


### 400
Bad request, the request is malformed or contains invalid data.

#### Body: application/json (object)
- **error** (string)
  A descriptive error message.

- **validation_errors** (array[object])


### 401
Unauthorized.

#### Body: application/json (object)
- **error** (string)
  A descriptive error message.


### 404
Employee or employer not found.

#### Body: application/json (object)
- **error** (string)
  A descriptive error message.



[Powered by Bump.sh](https://bump.sh)