--- title: "Create Employees" method: POST path: "/hris/employees" tags: ["hris/employees"] --- # Create Employees `POST /hris/employees` Create Employees in any supported Hris software ## Query parameters - `remote_data` boolean ## Headers - `x-connection-token` string, required ## Request body - UnifiedHrisEmployeeInput - `groups` string[], nullable — The groups the employee belongs to - `locations` string[], nullable — UUIDs of the of the Location associated with the company - `employee_number` string, nullable — The employee number - `company_id` string, nullable — The UUID of the associated company - `first_name` string, nullable — The first name of the employee - `last_name` string, nullable — The last name of the employee - `preferred_name` string, nullable — The preferred name of the employee - `display_full_name` string, nullable — The full display name of the employee - `username` string, nullable — The username of the employee - `work_email` string, nullable — The work email of the employee - `personal_email` string, nullable — The personal email of the employee - `mobile_phone_number` string, nullable — The mobile phone number of the employee - `employments` string[], nullable — The employments of the employee - `ssn` string, nullable — The Social Security Number of the employee - `gender` string, nullable — The gender of the employee - `ethnicity` string, nullable — The ethnicity of the employee - `marital_status` string, nullable — The marital status of the employee - `date_of_birth` string, date-time, nullable — The date of birth of the employee - `start_date` string, date-time, nullable — The start date of the employee - `employment_status` string, nullable — The employment status of the employee - `termination_date` string, date-time, nullable — The termination date of the employee - `avatar_url` string, nullable — The URL of the employee's avatar - `manager_id` string, nullable — UUID of the manager (employee) of the employee - `field_mappings` object, nullable — The custom field mappings of the object between the remote 3rd party & Panora ## Response `201` - UnifiedHrisEmployeeOutput - `groups` string[], nullable — The groups the employee belongs to - `locations` string[], nullable — UUIDs of the of the Location associated with the company - `employee_number` string, nullable — The employee number - `company_id` string, nullable — The UUID of the associated company - `first_name` string, nullable — The first name of the employee - `last_name` string, nullable — The last name of the employee - `preferred_name` string, nullable — The preferred name of the employee - `display_full_name` string, nullable — The full display name of the employee - `username` string, nullable — The username of the employee - `work_email` string, nullable — The work email of the employee - `personal_email` string, nullable — The personal email of the employee - `mobile_phone_number` string, nullable — The mobile phone number of the employee - `employments` string[], nullable — The employments of the employee - `ssn` string, nullable — The Social Security Number of the employee - `gender` string, nullable — The gender of the employee - `ethnicity` string, nullable — The ethnicity of the employee - `marital_status` string, nullable — The marital status of the employee - `date_of_birth` string, date-time, nullable — The date of birth of the employee - `start_date` string, date-time, nullable — The start date of the employee - `employment_status` string, nullable — The employment status of the employee - `termination_date` string, date-time, nullable — The termination date of the employee - `avatar_url` string, nullable — The URL of the employee's avatar - `manager_id` string, nullable — UUID of the manager (employee) of the employee - `field_mappings` object, nullable — The custom field mappings of the object between the remote 3rd party & Panora - `id` string, nullable — The UUID of the employee record - `remote_id` string, nullable — The remote ID of the employee in the context of the 3rd Party - `remote_data` object, nullable — The remote data of the employee in the context of the 3rd Party - `remote_created_at` string, date-time, nullable — The date when the employee was created in the 3rd party system - `created_at` string, date-time, nullable — The created date of the employee record - `modified_at` string, date-time, nullable — The last modified date of the employee record - `remote_was_deleted` boolean, nullable — Indicates if the employee was deleted in the remote system ## Changes - **2024-08-27** `5ba5c769e2e1` — 21 breaking, 21 info - removed the enum value `ACTIVE` of the request property `employment_status` - removed the enum value `AMERICAN_INDIAN_OR_ALASKA_NATIVE` of the request property `ethnicity` - removed the enum value `ASIAN_OR_INDIAN_SUBCONTINENT` of the request property `ethnicity` - removed the enum value `BLACK_OR_AFRICAN_AMERICAN` of the request property `ethnicity` - …38 more - **2024-08-13** `d5ae27a39da8` — 4 breaking, 21 warning, 25 info - request property `employment_status` was restricted to a list of enum values - request property `ethnicity` was restricted to a list of enum values - request property `gender` was restricted to a list of enum values - request property `marital_status` was restricted to a list of enum values - …46 more - **2024-08-13** `6c3a1da2bdc9` — 51 info - added the new optional request property `avatar_url` - added the new optional request property `company_id` - added the new optional request property `date_of_birth` - added the new optional request property `display_full_name` - …47 more - **2024-08-11** `04b9c7ceedbf` — 51 warning - removed the request property `avatar_url` - removed the request property `company_id` - removed the request property `date_of_birth` - removed the request property `display_full_name` - …47 more - …earlier changes not shown [Full history](https://skmtc.dev/panoratech/apis/panora-api/changes/hris/employees/post.md) --- [API](https://skmtc.dev/panoratech/apis/panora-api.md) · [All operations](https://skmtc.dev/panoratech/apis/panora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/panoratech/apis/panora-api/revisions/634ca9b624aa?raw)