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

# Register Deduction

`POST /employer/benefits/register`

Register existing benefits from the customer on the provider, on Finch's end. Please use the `/provider` 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
  - `frequency` 'every_paycheck' | 'monthly' | 'one_time' | 'null', nullable — The frequency of the benefit deduction/contribution.

## Response `201`

Successfully Created

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

## Other responses

- `400` — Requested adapter is not assisted benefits
- `422` — Request provided with unsupported parameters

## Changes

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

- **2025-10-27** `0105d239fcaf` — 1 info
  - added the new optional `query` request parameter `entity_ids`
- **2025-04-22** `46640c1b4688` — 1 info
  - the endpoint scheme security `bearerAuth` was added to the API

[Change history](https://skmtc.dev/finch-api/apis/api-reference/changes/employer/benefits/register/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)