---
title: "Create Deduction"
method: POST
path: "/employer/benefits"
tags: ["Deductions"]
---

# Create Deduction

`POST /employer/benefits`

Creates a new company-wide deduction or contribution. Please use the `/providers` endpoint to view available types for each provider.

## Query parameters

- `entity_ids` string[]

## Headers

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

## Request body

- object
  - `type` '457' | '401k' | '401k_roth' | '401k_loan' | '403b' | '403b_roth' | '457_roth' | 'commuter' | 'custom_post_tax' | 'custom_pre_tax' | 'fsa_dependent_care' | 'fsa_medical' | 'hsa_post' | 'hsa_pre' | 's125_dental' | 's125_medical' | 's125_vision' | 'simple' | 'simple_ira' | 'null', nullable — Type of benefit.
  - `description` string — Name of the benefit as it appears in the provider and pay statements. Recommend limiting this to <30 characters due to limitations in specific providers (e.g. Justworks).
  - `frequency` 'every_paycheck' | 'monthly' | 'one_time' | 'null', nullable — The frequency of the benefit deduction/contribution.
  - `company_contribution` BenefitCompanyMatchContribution, nullable — The company match for this benefit.
    - `type` 'match', required
    - `tiers` object[], required
      - `match` integer, required
      - `threshold` integer, required

## Response `201`

Successfully Created

- CreateCompanyBenefitsResponse
  - `benefit_id` string, uuid, required — The id of the benefit.
  - `job_id` string, uuid, required

## Other responses

- `400` — Malformed Request
- `422` — Request provided with unsupported parameters

## Changes

> 53 revisions in range; 3 could not be searched.

- **2025-10-27** `0105d239fcaf` — 1 info
  - added the new optional `query` request parameter `entity_ids`
- **2025-07-25** `73c284d36c1e` — 4 breaking
  - the request property `company_contribution/tiers` became required
  - the request property `company_contribution/tiers/items/match` became required
  - the request property `company_contribution/tiers/items/threshold` became required
  - the request property `company_contribution/type` became required
- **2025-05-08** `f09e5f2c555d` — 1 info
  - added the new optional request property `company_contribution`
- **2025-04-22** `46640c1b4688` — 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- **2025-04-10** `bf858f37d7ab` — 1 info
  - added the required property `job_id` to the response with the `201` status

[Change history](https://skmtc.dev/finch-api/apis/api-reference/changes/employer/benefits/post.md)

---

[API](https://skmtc.dev/finch-api/apis/api-reference.md) · [All operations](https://skmtc.dev/finch-api/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finch-api/api-reference/revisions/f1cca2cb0ef2/schema)