# Update employer

**PATCH /employers/{employerId}**

Update an employer's configuration. All fields are optional — only
provided fields are updated.



## Servers
- Production: https://partner-api.getpenfold.com/v1 (Production)
- Staging: https://partner-api.getpenfold.dev/v1 (Staging)


## Authentication methods
- Bearer auth


## Parameters

### Path parameters
- **employerId** (string(uuid))
  Penfold employer UUID


### Body: application/json (object)

- **primaryContactEmail** (string(email))
  Email address of the primary contact at the employer
- **primaryContactName** (string)
  Full name of the primary contact at the employer
- **primaryContactRole** (string)
  Role of the primary contact at the employer
- **defaultEmployeeContributionsPercent** (number)
  Default employee contribution percentage
- **defaultEmployerContributionsPercent** (number)
  Default employer contribution percentage
- **contributionBasis** (string)
  Basis on which pension contributions are calculated
- **allowsSalarySacrifice** (boolean)
  Whether the employer allows salary sacrifice arrangements
- **payrollFrequencies** (array[string])
  How often the employer runs payroll


## Responses
### 200
Employer updated successfully.

#### Body: application/json (object)
- **id** (string(uuid))
  Unique identifier for the employer
- **name** (string)
  Employer name
- **externalReference** (string)
  Penfold employer reference (`PEN` + Companies House number)
- **companyNumber** (string)
  Companies House number
- **status** (string)
  Current status of the employer:
  - `AwaitingAgreement`: Employer must complete onboarding on Penfold's platform (agreement, AML/KYB)
  - `Pending`: Onboarding complete, awaiting first payroll submission
  - `Active`: Fully operational, can process payroll
  - `Closed`: Employer account closed
- **defaultEmployeeContributionsPercent** (number)
  Default employee contribution percentage
- **defaultEmployerContributionsPercent** (number)
  Default employer contribution percentage
- **contributionBasis** (string)
  Basis on which pension contributions are calculated
- **allowsSalarySacrifice** (boolean)
  Whether the employer allows salary sacrifice
- **paymentMethod** (string)
  Payment method for pension contributions
- **createdAt** (string(date-time))
  When the employer was created (ISO 8601)

### 400
Request body failed validation

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


### 401
Missing or invalid authentication token

#### Body: application/json (object)
- **error** (string)


### 404
Resource not found

#### Body: application/json (object)
- **error** (string)


### 500
Internal server error

#### Body: application/json (object)
- **error** (string)



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