---
title: "Post a Preboarding Candidate"
method: POST
path: "/v1/hire/preboarding/candidates"
tags: ["PreboardingAPI"]
---

# Post a Preboarding Candidate

`POST /v1/hire/preboarding/candidates`

## Request

- Base URL: `https://{company}.keka.com/api`
- URL: `https://{company}.keka.com/api/v1/hire/preboarding/candidates`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://login.kekad.com/connect/token`

Adds a Preboarding Candidate

## Request body

- PreboardingCandidateDTO: Dto for preboarding candidate.
  - `id` string, nullable: Gets or sets the identifier.
  - `firstName` string, nullable: Gets or sets the FirstName.
  - `middleName` string, nullable: Gets or sets the MiddleName.
  - `lastName` string, nullable: Gets or sets the lastName.
  - `email` string, nullable: Gets or sets Email.
  - `countryCode` string, nullable: Gets or sets Country code.
  - `mobileNumber` string, nullable: Gets or sets MobileNumber.
  - `jobtitle` string, nullable: Gets or sets Jobtitle.
  - `gender` 0 | 1 | 2 | 3 | 4 | 5
  - `department` string, nullable: Gets or sets Department.
  - `workLocation` string, nullable: Gets or sets WorkLocation.
  - `expectedDateOfJoining` string, date-time, nullable: Gets or sets ExpectedDateOfJoining.
  - `stage` 0 | 1 | 2 | 3 | 4 | 5
  - `status` 0 | 1 | 2 | 3 | 4 | 5

## Response `200`

Success

- string

## Other responses

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

---

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