---
title: "Submit an employee form"
method: POST
path: "/employees/{employee}/forms/{form}/submit"
---

# Submit an employee form

`POST /employees/{employee}/forms/{form}/submit`

## Request

- Base URL: `https://sandbox.checkhq.com`
- URL: `https://sandbox.checkhq.com/employees/{employee}/forms/{form}/submit`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/checkhq/apis/check-api/docs/employees/:employee/forms/:form/submit/post.ts> (a function with typed inputs; its response is checked against the schema)

Submits an employee form.

**Note: **Employee withholdings are normally configured when employees go through [Check Onboard](https://docs.checkhq.com/docs/check-onboard). Use the Employee Forms API only if you're building a custom integration for employee onboarding.

Consult the [Custom Employee Onboarding Guide](https://docs.checkhq.com/docs/employee-onboarding-api#3-employee-withholdings-api) for more information.

## Path parameters

- `employee` string, required
- `form` string, required

## Request body

- object
  - `parameters` object[]: An array of name-value pair objects, which represent the fields available on your form.
    - `name` string
    - `value` string

## Response `200`

200

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `5a54f5eb888b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/checkhq/apis/check-api/changes/employees/:employee/forms/:form/submit/post.md)

---

[API](https://skmtc.dev/checkhq/apis/check-api.md) - [All operations](https://skmtc.dev/checkhq/apis/check-api/llms.txt) - [OpenAPI document](https://skmtc.dev/checkhq/apis/check-api/revisions/5a54f5eb888b?raw)