---
title: "Create company employee."
method: POST
path: "/people"
tags: ["People"]
---

# Create company employee.

`POST /people`

<br>This endpoint allows you to create a new employee in the system. <br> The request body must include the minimum required fields: `email`, `firstName`, `surname`, and the `work` object with `site` and `startDate`.<br> While not all fields are mandatory, we recommend populating as many fields as possible to ensure complete employee records from the start. <br> Specifically, it's recommended to include `work.department` and `work.title`.  <br>You can include **any additional fields** from the [Fields Metadata API](https://apidocs.hibob.com/reference/get_company-people-fields) to enrich the employee's profile during creation.

## Request body

- CreateEmployeeRequest
  - `firstName` string, required — Employee's first name. Max length: 50, can only contain letters and `´`̀_-;,̩.\/'’"()`
  - `surname` string, required — Employee's surname. Max length: 50, can only contain letters and `´`̀_-;,̩.\/'’"()`
  - `email` string, email, required — Employee's email address. Must be a valid email address, unique within the company
  - `work` object, required
    - `site` string, required — The employee's site. Must be a valid list-item from the `site` list (use the display value, not the backend-id)
    - `startDate` string, date, required — The employee's employment start date - format: YYYY-MM-DD
    - `department` string — The department the employee belonged to for this work entry. Must be a valid list-item from the `department` list.
    - `title` string — The job title for the employee for this work entry. Must be a valid list-item from the `title` list

## Response `200`

Employee

- EmployeeResponseMachineFormat
  - `fullName` string — The full name of the Employee (first name + surname).
  - `/work/indirectReports` string[] — The internal IDs of the people the Employee reports to indirectly.
  - `/about/avatar` object — The avatar URL of the employee.
    - `value` string
  - `/work/reportsTo/email` object — The email of the person the employee reports to.
    - `value` string
  - `displayName` string — Employee's display name. This defaults to first name & last name but can be customized.
  - `/root/firstName` object — The first name of the employee.
    - `value` string
  - `/work/employeeIdInCompany` object — The internal ID of the employee.
    - `value` number
  - `/work/tenureDurationYears` object — The tenure duration in exact years of the employee.
    - `value` number
  - `/about/foodPreferences` object — The food preferences of the employee.
    - `value` string
  - `/work/site` object — The site name of the employee.
    - `value` string
  - `/work/tenureYears` object — The tenure duration in years of the employee (rounded value).
    - `value` string
  - `creationDateTime` string — The full timestamp of creation of the Employee.
  - `hobbies` object
    - `value` string[] — An array of the employee's hobbies.
  - `/root/email` object — The employee's email.
    - `value` string
  - `/work/title` object — The employee's title.
    - `value` string
  - `employee` object
    - `payrollManager` string
    - `hrbp` string
    - `itAdmin` string
    - `buddy` string
  - `work` object
    - `shortStartDate` string, date — The employee's employment start date without the year
    - `startDate` string, date — The employee's employment start date without the year
    - `manager` string — The full name of the employee's manager.
    - `tenureDuration` object — The tenure duration of the employee.
      - `periodISO` string
      - `sortFactor` number
      - `humanize` string
    - `custom` string[] — The custom fields of the employee.
    - `durationOfEmployment` object — The tenure duration of employment of the employee.
      - `periodISO` string
      - `sortFactor` number
      - `humanize` string
    - `reportsToIdInCompany` number — The ID in company of the manager.
    - `employeeIdInCompany` number — The ID of the manager.
    - `reportsTo` object — The full name of the person the employee reports to.
      - `displayName` string
      - `email` string
      - `surname` string
      - `firstName` string
      - `id` string
    - `workMobile` string — The work mobile number.
    - `workPhone` string — The work phone number.
    - `indirectReports` number — The person this employee reports to indirectly.
    - `siteID` number — The ID of the site the employee belongs to.
    - `tenureDurationYears` number — The tenture duration in years.
    - `department` string — The department this employee belong to.
    - `tenureYears` number — The tenture in years.
    - `isManager` string — Is the employee a manager (Yes/No).
    - `title` string — The employee's title.
    - `site` string — The employee's site.
    - `originalStartDate` string — The original date the employee started to work
    - `activeEffectiveDate` string — The active effective date the employee started to work
    - `directReports` number — The internal ID of the person this employee reports to directly
    - `secondLevelManager` string — The ID of the manager in the second level
    - `daysOfPreviousService` number — The number of days in previous service
    - `yearsOfService` number — The number of years in service
  - `avatarUrl` string — The URL of the source of the avatar image.
  - `secondName` string — Employee's surname.
  - `about` object
    - `foodPreferences` string[] — Employee's food preferences.
    - `socialData` object — Employee's social data.
      - `linkedin` string
      - `twitter` string
      - `facebook` string
    - `superpowers` string[] — Employee's super powers.
    - `hobbies` string[] — A list of the employee's hobbies.
    - `about` string — Employee's about sentence.
    - `avatar` string — Image URL of the employee's avatar.
  - `/root/fullName` object — The employee's full name.
    - `value` string
  - `companyId` number — The ID of the employee's company.
  - `/root/coverImageUrl` object — The employee's cover image.
    - `value` string
  - `/work/secondLevelManager` object — The ID of the second level manager of the employee.
    - `value` string
  - `/work/directReports` object — The number of people the employee reports to directly.
    - `value` number
  - `/work/yearsOfService` object — The number of years the employee has been in service.
    - `value` number
  - `/work/daysOfPreviousService` object — The number of years the employee has been in service previously.
    - `value` number
  - `/about/about` object — Employee's about sentence.
    - `value` string
  - `/root/avatarUrl` object — The url for the avatar file of the employee.
    - `value` string
  - `/work/shortStartDate` object — The start date of the employee in a short format (without the year).
    - `value` string
  - `/work/activeEffectiveDate` object — The date the employee bacame active.
    - `value` string
  - `/root/id` object — The ID of the employee.
    - `value` string
  - `email` string, email — Employee's email address.
  - `/work/manager` object — The ID of the employee's manager.
    - `value` string
  - `surname` string — Employee's surname.
  - `/work/reportsTo` object — The details of the person the employee reports to.
    - `value` object
      - `displayName` string
      - `email` string
      - `surname` string
      - `firstName` string
      - `id` string
  - `/root/companyId` object — The ID of the employee's company.
    - `value` number
  - `/root/displayName` object — The display name of the employee.
    - `value` string
  - `/work/department` object — The department of the employee.
    - `value` string
  - `/work/isManager` object — The department of the employee.
    - `value` boolean
  - `/work/originalStartDate` object — The original date the employee started work.
    - `value` string
  - `coverImageUrl` string — The URL of the cover image.
  - `/work/reportsToIdInCompany` object — The ID of the person this employee reports to.
    - `value` number
  - `/work/tenureDuration` object — The tenture duration of the employee.
    - `value` object
      - `periodISO` string
      - `sortFactor` number
      - `humanize` string
  - `/about/superpowers` object — The super powers of the employee.
    - `value` string[]
  - `id` string — A unique identifier representing a specific employee.
  - `firstName` string — Employee's first name.
  - `/work/siteId` object — The site ID of the employee's site.
    - `value` number
  - `/work/durationOfEmployment` object — The duration of the employee's employment.
    - `value` object
      - `periodISO` string
      - `sortFactor` number
      - `humanize` string

## Other responses

- `400` — Bad request. The request contains incorrect parameters or syntax errors. Please review the request body
- `403` — Forbidden. The service user does not have permissions to access this table or employees. Check the permissions as explained in the endpoint description.
- `429` — "Too Many Requests" error. This indicates that you've exceeded the rate limit for requests. Please verify that you are using the correct endpoint with the POST method. Additionally, check the HTTP headers for rate limit information, such as the number of requests allowed and the time until the limit resets. For more details, see <a href="https://apidocs.hibob.com/docs/rate-limit" target="_blank">Rate Limiting</a>.

---

[API](https://skmtc.net/hibob/apis/employee-data-api.md) · [All operations](https://skmtc.net/hibob/apis/employee-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hibob/employee-data-api/versions/0781ebbdda91/schema)