> For the complete documentation index, see [llms.txt](https://docs.cootje.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cootje.com/cootje-api/recruitment.md).

# Recruitment

Vacatures en kandidaten beheren via de Cootje API.

Met de recruitment-aanroepen beheer je vacatures en kandidaten in Cootje en vraag je de analyses op die AI daarover maakt. Dit onderdeel is bedoeld voor koppelingen met bijvoorbeeld een vacaturesite of een eigen recruitmentsysteem.

## In dit onderdeel

| Pagina                                                                       | Wat je er vindt                                                     |
| ---------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| [Vacatures](https://docs.cootje.com/cootje-api/recruitment/vacatures.md)     | Vacatures ophalen, aanmaken, bijwerken en verwijderen.              |
| [Kandidaten](https://docs.cootje.com/cootje-api/recruitment/kandidaten.md)   | Kandidaten ophalen, aanmaken, bijwerken en verwijderen.             |
| [AI Analyses](https://docs.cootje.com/cootje-api/recruitment/ai-analyses.md) | De matching score van kandidaten en de zzp-validatie van vacatures. |

## Goed om te weten

* Een **kandidaat** is een profiel voor werving. Het is iets anders dan een persoon in Cootje: een kandidaat kan niet inloggen en heeft geen contracten.
* Een vacature hoort altijd bij een klant. Die moet al in Cootje staan, zie [Klant / Inlener](https://docs.cootje.com/cootje-api/klant-inlener.md).
* Een kandidaat koppel je aan een vacature met `POST /recruiter/relations`. Die aanroep staat in de [API-referentie (Swagger)](https://mijn.cootje.com/api/swagger).
* Mist het API-account het vereiste recht, dan is het antwoord `401`.
