--- updatedAt: 2025-10-12T20:27:54.000Z agentTools: projectIndex: https://docs.checkhq.com/llms.txt --- # Create an employee Creates an employee. > 👍 Bulk Create Employees > > This endpoint also supports bulk creation of employees. You can pass in a json array of employees in the body of the request. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "check-api", "version": "2025-01-01" }, "servers": [ { "url": "https://sandbox.checkhq.com" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "in": "header", "name": "Authorization", "x-bearer-format": "bearer", "x-default": "YOUR_API_KEY" } } }, "security": [ { "sec0": [] } ], "paths": { "/employees": { "post": { "summary": "Create an employee", "description": "Creates an employee.", "operationId": "create-an-employee", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "last_name", "company", "workplaces" ], "properties": { "first_name": { "type": "string", "description": "Employee's first name" }, "middle_name": { "type": "string", "description": "Employee's middle name, if available" }, "last_name": { "type": "string", "description": "Employee's last name" }, "email": { "type": "string", "description": "Employee's email address" }, "dob": { "type": "string", "description": "Employee's date of birth. Until dob is added, it will show up as a blocking employee onboard step.", "format": "date" }, "residence": { "type": "object", "description": "Employee residence used for calculating state income taxes. Until residence is added, it will show up as a blocking employee onboard step. You may not unset residence once it is set.", "required": [ "line1", "city", "state", "postal_code" ], "properties": { "line1": { "type": "string", "description": "Street address or PO Box" }, "line2": { "type": "string", "description": "Apartment, suite, unit, or building" }, "city": { "type": "string", "description": "City, district, suburb, town, or village" }, "state": { "type": "string", "description": "2-digit state code" }, "postal_code": { "type": "string", "description": "5-digit postal code or zip code" }, "country": { "type": "string", "description": "Read only.", "default": "US" } } }, "company": { "type": "string", "description": "ID of employee's company" }, "start_date": { "type": "string", "description": "Most recent start date of employment. Until start date is added, it will show up as a blocking employee onboard step.", "format": "date" }, "termination_date": { "type": "string", "description": "Most recent date of employment termination. Will be set to null if a more recent start date is set.", "format": "date" }, "default_net_pay_split": { "type": "string", "description": "ID of employee's net pay split" }, "workplaces": { "type": "array", "description": "IDs of workplaces where the employee works. Optionally, an empty list can be passed in and workplaces can be added after employee creation. Until the workplaces are added, this will show up as a blocking step in the onboarding status.", "items": { "type": "string" } }, "primary_workplace": { "type": "string", "description": "The Workplace ID of the employee's primary workplace." }, "ssn": { "type": "string", "description": "Employee's TIN (usually their Social Security Number). Must be unique across all employees in a company. Only the last four digits of an SSN will be made available in `ssn_last_four` after being set." }, "payment_method_preference": { "type": "string", "description": "Either \"direct_deposit\" or \"manual\", default null" }, "active": { "type": "boolean", "description": "Indicates whether the employee is currently employed. Used only for filtering.", "default": true }, "w2_electronic_consent_provided": { "type": "boolean", "description": "Indicates whether the employee has opted into electronic delivery of W2 PDF.", "default": false }, "metadata": { "type": "string", "description": "Additional loosely structured information to associate with the employee", "format": "json" } } } } } }, "responses": { "201": { "description": "201", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"id\": \"emp_zGGp6wYcxAeu1Ng8IA7v\",\n \"first_name\": \"Tony\",\n \"last_name\": \"Stark\",\n \"middle_name\": null,\n \"email\": \"tony@starkindustries.com\",\n \"dob\": \"1970-05-29\",\n \"bank_accounts\": [],\n \"ssn_last_four\": null,\n \"payment_method_preference\": null,\n \"active\": true,\n \"onboard\": {\n \"status\": \"blocking\",\n \"blocking_steps\": [\n \"ssn\"\n ],\n \"remaining_steps\": [\n \"ssn\",\n \"payment_method\"\n \"withholdings\",\n ],\n \"ssn\": [\n \"ssn_submitted\",\n ],\n \"payment_method\": [\n \"payment_method_preference_set\",\n \"bank_account_exists\",\n \"bank_account_verified\",\n ],\n \"withholdings\": [\n {\n \"id\": \"jur_kSO0VneVfdx5TDDQ9Xnp\",\n \"name\": \"Federal\", \n },\n {\n \"id\": \"jur_CUlTApePRnDFn9bPVCQE\",\n \"name\": \"New York\", \n }, \n ],\n },\n \"workplaces\": [\n \"wrk_i8nfu8234r8dkjhzlsdv\"\n ],\n \"company\": \"com_sx3svU6K8c5ZkSFlOh5p\",\n \"start_date\": \"2019-03-01\",\n \"termination_date\": null,\n \"residence\": {\n \"line1\": \"630 Bedford Road\",\n \"line2\": null,\n \"city\": \"Tarrytown\",\n \"state\": \"NY\",\n \"postal_code\": \"10591\",\n \"country\": \"US\"\n },\n \"w2_electronic_consent_provided\": false,\n \"metadata\": {}\n}" } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```