---
title: "Create an Employee"
method: POST
path: "/hris/employees"
tags: ["Employees"]
---

# Create an Employee

`POST /hris/employees`

## Request

- Base URL: `https://{company}.keka.com/api/v1`
- URL: `https://{company}.keka.com/api/v1/hris/employees`
- Auth: OAuth 2
  - Implicit: `https://login.keka.com/connect/authorize`

Create an Employee and returns created employee identifier.

## Request body

- Employee
  - `employeeNumber` string, nullable
  - `displayName` string, nullable
  - `firstName` string, nullable
  - `middleName` string, nullable
  - `lastName` string, nullable
  - `email` string, nullable
  - `mobileNumber` string, nullable
  - `gender` 0 | 1 | 2 | 3
  - `dateOfBirth` string, date-time
  - `dateJoined` string, date-time
  - `department` string, nullable
  - `businessUnit` string, nullable
  - `jobTitle` string, nullable
  - `secondaryJobTitle` string, nullable
  - `location` string, nullable
  - `legalEntity` string, nullable
  - `nationality` string, nullable

## Response `200`

OK

- StringResponse: class represents response.
  - `succeeded` boolean: Gets or sets a value indicating whether this Keka.API.Web.Core.Response`1 is succeeded.
  - `message` string, nullable: Gets or sets the message.
  - `errors` string[], nullable: Gets or sets the errors.
  - `data` string, nullable: Gets or sets the data.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/keka/apis/core-hr.md) - [All operations](https://skmtc.dev/keka/apis/core-hr/llms.txt) - [OpenAPI document](https://skmtc.dev/keka/apis/core-hr/revisions/d4f1d9facc7b?raw)