Enrol employee in pension scheme
Records an employee’s enrolment in the workplace pension scheme. Use this to record auto-enrolment triggered by eligibility assessment, voluntary opt-in by a non-eligible jobholder, or a worker choosing to join. If a membership record does not yet exist, one is created automatically. Returns 409 if the employee is already actively enrolled — use the opt-out endpoint first if re-enrolment is needed after a status change.
Body
- AutoEnrolRequest
- OptInRequest
- JoinRequest
Auto-enrolment triggered by an AE eligibility assessment.
Used when the payroll engine determines the employee is an eligible jobholder or when a manual auto-enrolment is recorded. Requires the caller to supply the enrolment_date and worker_category explicitly.
Response
Successful Response
Current pension membership state for an employee.
Reflects the latest (highest version) membership history record. Per-employee rate override fields (employee_rate, employer_rate, etc.) are null when the scheme defaults apply; non-null values take precedence over the scheme.
AE worker category at enrolment time: ELIGIBLE_JOBHOLDER (age 22–SPA, earnings ≥ trigger — employer must enrol), NON_ELIGIBLE_JOBHOLDER (outside age/earnings band — can opt in), ENTITLED_WORKER (earnings below lower limit — can join, employer need not contribute), EXCLUDED (not subject to AE). Null if not yet enrolled
ELIGIBLE_JOBHOLDER, NON_ELIGIBLE_JOBHOLDER, ENTITLED_WORKER, EXCLUDED