--- 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-09-20** `be3dc330edf3` — 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-16** `660a45415efe` — 55 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` - …51 more - **2024-08-05** `ca213ae36b7f` — 1 info - the endpoint scheme security `bearer` was removed from the API - **2024-08-05** `167edd5346ec` — 1 info - the endpoint scheme security `bearer` was added to the API - **2024-08-01** `414c3e999e0b` — 1 info - the endpoint scheme security `bearer` was removed from the API [Change history](https://skmtc.dev/panoratech/apis/panora-api-2/changes/hris/employees/post.md) --- [API](https://skmtc.dev/panoratech/apis/panora-api-2.md) · [All operations](https://skmtc.dev/panoratech/apis/panora-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/panoratech/apis/panora-api-2/revisions/be3dc330edf3?raw)