# Recruitments

Group: People Management

[Open in the interactive reference](https://docs.api.lensing.ai/lensing/v1/groups/peopleRecruitments)

A recruitment is one job opening.

A recruitment belongs to a department, a position, or both. A recruitment can also name a team, a work location, an employment category, and the legal entity that will employ the hire. A hiring manager and a recruitment owner run each recruitment.

Three fields are set for you, and a request can't change them. status comes from the deadline, published changes when the recruitment is published externally, and recruitmentNumber comes from a number range.

## Endpoints

- [List recruitments](https://docs.api.lensing.ai/reference/lensing/v1/endpoints/recruitments.html): `GET /people/recruitments`
- [Create a recruitment](https://docs.api.lensing.ai/reference/lensing/v1/endpoints/createRecruitment.html): `POST /people/recruitments`
- [Retrieve a recruitment](https://docs.api.lensing.ai/reference/lensing/v1/endpoints/getRecruitment.html): `GET /people/recruitments/{id}`
- [Update a recruitment](https://docs.api.lensing.ai/reference/lensing/v1/endpoints/updateRecruitment.html): `PATCH /people/recruitments/{id}`