---
title: "employee"
method: POST
path: "/v{version}/companies/{company_id}/employees"
tags: ["Employee"]
---

# employee

`POST /v{version}/companies/{company_id}/employees`

Create a new employee.<p>Scopes: update_employee</p>

## Path parameters

- `company_id` string, required
- `version` string, required

## Request body

- DtosEmployeeEditable
  - `eid` string — External identifier for importing purposes. Auto-assigned if not provided.
  - `payroll_id` string — External Payroll Id.
  - `type` 'Full-Time' | 'Part-Time' | 'Variable-Hour' | 'Contractor' | 'Seasonal' | 'Intern', required — Type
  - `status` 'Active' | 'Leave of Absence' | 'COBRA' | 'Terminated' | 'Resigned' | 'Deceased' | 'Retired' | 'Applicant' | 'Test', required — Status.
  - `status_effective_date` string — The effective date of the status change, only required for status updates.
  - `status_reason` string — The reason recorded for the status change, only required for status updates.
  - `termination_type` 'Involuntary' | 'Voluntary' | 'Gross Misconduct' — Type of termination, only required when status is terminated.
  - `ssn` string, required — Social Security Number.
  - `first_name` string, required — First Name.
  - `middle_name` string — Middle Name.
  - `last_name` string, required — Last Name.
  - `home_address` DtosAddress
    - `addr1` string — The street address.
    - `addr2` string — Secondary field for street address.
    - `city` string — The city.
    - `state` string — The state. Can be the 2 letter state abbreviation or the full state name.
    - `zip` string — The postal code.
    - `county` string — The county.
    - `country` 'Afghanistan' | 'Albania' | 'Algeria' | 'Argentina' | 'Armenia' | 'Australia' | 'Austria' | 'Azerbaijan' | 'Bahrain' | 'Bangladesh' | 'Belarus' | 'Belgium' | 'Belize' | 'Benin' | 'Bhutan' | 'Bolivarian Republic of Venezuela' | 'Bolivia' | 'Bosnia and Herzegovina' | 'Botswana' | 'Brazil' | 'Brunei Darussalam' | 'Bulgaria' | 'Burundi' | 'Cambodia' | 'Cameroon' | 'Canada' | 'Caribbean' | 'Chile' | 'Colombia' | 'Congo (DRC)' | 'Costa Rica' | 'Côte d'Ivoire' | 'Croatia' | 'Cuba' | 'Cyprus' | 'Czech Republic' | 'Denmark' | 'Djibouti' | 'Dominican Republic' | 'Ecuador' | 'Egypt' | 'El Salvador' | 'Eritrea' | 'Estonia' | 'Ethiopia' | 'Faroe Islands' | 'Fiji' | 'Finland' | 'France' | 'Gambia' | 'Georgia' | 'Germany' | 'Ghana' | 'Greece' | 'Greenland' | 'Guatemala' | 'Haiti' | 'Honduras' | 'Hong Kong S.A.R.' | 'Hungary' | 'Iceland' | 'India' | 'Indonesia' | 'Iran' | 'Iraq' | 'Ireland' | 'Islamic Republic of Pakistan' | 'Israel' | 'Italy' | 'Jamaica' | 'Japan' | 'Jordan' | 'Kazakhstan' | 'Kenya' | 'Korea' | 'Kuwait' | 'Kyrgyzstan' | 'Lao P.D.R.' | 'Latin America' | 'Latvia' | 'Lebanon' | 'Liberia' | 'Libya' | 'Liechtenstein' | 'Lithuania' | 'Luxembourg' | 'Macao S.A.R.' | 'Malaysia' | 'Maldives' | 'Mali' | 'Malta' | 'Mexico' | 'Moldova' | 'Mongolia' | 'Montenegro' | 'Morocco' | 'Myanmar' | 'Namibia' | 'Nepal' | 'Netherlands' | 'New Zealand' | 'Nicaragua' | 'Nigeria' | 'North Macedonia' | 'Norway' | 'Oman' | 'Palestine' | 'Panama' | 'Paraguay' | 'People's Republic of China' | 'Peru' | 'Philippines' | 'Poland' | 'Portugal' | 'Principality of Monaco' | 'Puerto Rico' | 'Qatar' | 'Réunion' | 'Romania' | 'Russia' | 'Rwanda' | 'Saudi Arabia' | 'Senegal' | 'Serbia' | 'Sierra Leone' | 'Singapore' | 'Slovakia' | 'Slovenia' | 'Somalia' | 'South Africa' | 'Spain' | 'Sri Lanka' | 'Sudan' | 'Sweden' | 'Switzerland' | 'Syria' | 'Taiwan' | 'Tajikistan' | 'Tanzania' | 'Thailand' | 'Trinidad and Tobago' | 'Tunisia' | 'Turkey' | 'Turkmenistan' | 'U.A.E.' | 'Uganda' | 'Ukraine' | 'United Kingdom' | 'United States' | 'Uruguay' | 'Uzbekistan' | 'Vietnam' | 'Yemen' | 'Zambia' | 'Zimbabwe' — The country.
    - `region` string — The region.
  - `email` string — Email Address.
  - `birth_date` string — Date of Birth.
  - `gender` 'Male' | 'Female' | '' — Gender.
  - `personal_email` string — Personal Email Address.
  - `home_phone` string — Home Phone Number.
  - `mobile_phone` string — Mobile Phone Number.
  - `work_phone` string — Work Phone Number.
  - `marital` '' | 'Single' | 'Married' | 'Divorced' | 'Domestic Partner' | 'Legally Separated' | 'Widowed' — Marital Status.
  - `hire_date` string — If the employee is not terminated, the latest HireDate is returned, otherwise the employee's OriginalHireDate.
  - `job_title` string — The employee's job title.
  - `payroll_group` string — Payroll Group.
  - `department` string — Department name.
  - `location` string — Employment location name.
  - `job_class` string — Job class name.
  - `division` string — Division name.
  - `hours` number, double — Hours.
  - `pay_cycle` 'Annually' | '2 Pay Periods' | '3 Pay Periods' | '4 Pay Periods' | '5 Pay Periods' | '6 Pay Periods' | '7 Pay Periods' | '8 Pay Periods' | '9 Pay Periods' | '10 Pay Periods' | '11 Pay Periods' | 'Monthly' | '13 Pay Periods' | '14 Pay Periods' | '15 Pay Periods' | '16 Pay Periods' | '17 Pay Periods' | '18 Pay Periods' | '19 Pay Periods' | '20 Pay Periods' | '21 Pay Periods' | '22 Pay Periods' | '23 Pay Periods' | 'Semi-Monthly' | '25 Pay Periods' | 'Bi-Weekly' | '27 Pay Periods' | '28 Pay Periods' | '29 Pay Periods' | '30 Pay Periods' | '31 Pay Periods' | '32 Pay Periods' | '33 Pay Periods' | '34 Pay Periods' | '35 Pay Periods' | '36 Pay Periods' | '37 Pay Periods' | '38 Pay Periods' | '39 Pay Periods' | '40 Pay Periods' | '41 Pay Periods' | '42 Pay Periods' | '43 Pay Periods' | '44 Pay Periods' | '45 Pay Periods' | '46 Pay Periods' | '47 Pay Periods' | '48 Pay Periods' | '49 Pay Periods' | '50 Pay Periods' | '51 Pay Periods' | 'Weekly' — Pay Cycle.

## Response `200`

Success

- ControllersEmployeeResult
  - `external_id` string — The provided employee id.
  - `id` string — Ease generated employee id.

---

[API](https://skmtc.net/ease/apis/version-2.md) · [All operations](https://skmtc.net/ease/apis/version-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ease/version-2/revisions/be66ed178abe/schema)