Sign in
Deductions

Create Deduction

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

post/employer/benefits

Headers

Finch-API-Versionstring date required

Header used to specify the version for a given API request. Current version is 2020-09-17.

Content-Typestring required

Used to indicate the original media type of the resource

Request body

type'401k' | '401k_roth' | '401k_loan' | '403b' | '403b_roth' | '457' | '457_roth' | 's125_medical' | 's125_dental' | 's125_vision' | 'hsa_pre' | 'hsa_post' | 'fsa_medical' | 'fsa_dependent_care' | 'simple_ira' | 'simple' | 'commuter' | 'custom_post_tax' | 'custom_pre_tax' | 'null' nullable

Type of benefit.

descriptionstring

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'one_time' | 'every_paycheck' | 'monthly' | 'null' nullable

The frequency of the benefit deduction/contribution.

Response

Successfully Created

benefit_idstring uuid required

The id of the benefit.

job_idstring uuid required

Changes