---
title: "Enroll Individuals in Deductions"
method: POST
path: "/employer/benefits/{benefit_id}/individuals"
tags: ["Deductions"]
---

# Enroll Individuals in Deductions

`POST /employer/benefits/{benefit_id}/individuals`

Enroll an individual into a deduction or contribution. This is an overwrite operation. If the employee is already enrolled, the enrollment amounts will be adjusted. Making the same request multiple times will not create new enrollments, but will continue to set the state of the existing enrollment.

## Query parameters

- `entity_ids` string[]

## Headers

- `Finch-API-Version` string, date, required
- `Content-Type` string, required

## Request body

- object[] — Array of the individual_id to enroll and a configuration object.
  - `individual_id` string — Finch id (uuidv4) for the individual to enroll
  - `configuration` object
    - `employee_deduction` object
      - `type` 'fixed' | 'percent'
      - `amount` integer — Amount in cents for fixed type or basis points (1/100th of a percent) for percent type
    - `company_contribution` object
      - `type` 'fixed' | 'percent' | 'tiered'
      - `amount` integer — Amount in cents for fixed type or basis points (1/100th of a percent) for percent type
      - `tiers` object[] — Array of tier objects for tiered contribution matching (required when type is tiered)
        - `match` integer, required — The employer match percentage in basis points (0-10000 = 0-100%)
        - `threshold` integer, required — The employee contribution threshold in basis points (0-10000 = 0-100%)
    - `annual_maximum` integer, nullable — Maximum annual amount in cents
    - `annual_contribution_limit` 'individual' | 'family' — For HSA benefits only - whether the contribution limit is for an individual or family
    - `catch_up` boolean — For retirement benefits only - whether catch up contributions are enabled
    - `effective_date` string, date — The date the enrollment will take effect

## Response `200`

Successfully enqueued job to enroll individuals in the benefit

- EnrollIndividualBenefitResponse
  - `job_id` string, uuid, required

## Other responses

- `400` — Malformed Request
- `404` — Benefit Not Found
- `422` — Unprocessable Request

---

[API](https://skmtc.net/finch-api/apis/api-reference.md) · [All operations](https://skmtc.net/finch-api/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finch-api/api-reference/versions/844e1a4ed34f/schema)