---
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

---

[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/revisions/f1cca2cb0ef2/schema)