> 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/kandidaten/aanmaken.md).

# Aanmaken

Een kandidaat aanmaken: verplichte en optionele velden, met een voorbeeld.

Hiermee maak je een nieuwe kandidaat aan. Alleen de naam is altijd verplicht.

* **Aanroep:** `POST /recruiter/candidates`
* **Vereist recht:** Alle kandidaten bewerken

## Verplichte velden

| Veld   | Soort | Toelichting              |
| ------ | ----- | ------------------------ |
| `name` | tekst | De naam van de kandidaat |

## Verplicht in bepaalde gevallen

| Situatie                                                               | Dan verplicht                                                            |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| De kandidaat wordt aangeboden via een leverancier (`offerForm` is `2`) | `supplier` met daarin `companyName`, `contactName` en een geldig `email` |
| Je stuurt werkervaring mee (`experiences`)                             | Per regel `title` en `company`                                           |
| Je stuurt opleidingen mee (`educations`)                               | Per regel `title`                                                        |
| Je vult `zipCode` in                                                   | Een Nederlandse postcode, zoals `1234 AB`                                |

## Optionele velden

| Veld                                        | Soort           | Toelichting                                                                                                                                                                     |
| ------------------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `email`                                     | tekst           | E-mailadres                                                                                                                                                                     |
| `phone`                                     | tekst           | Telefoonnummer                                                                                                                                                                  |
| `title`                                     | tekst           | Functietitel van de kandidaat                                                                                                                                                   |
| `address`, `houseNumber`, `zipCode`, `city` | tekst           | Adres: straat, huisnummer, postcode en plaats                                                                                                                                   |
| `linkedIn`                                  | tekst           | Adres van het LinkedIn-profiel                                                                                                                                                  |
| `gender`                                    | getal           | `1` man, `2` vrouw                                                                                                                                                              |
| `skills`                                    | lijst met tekst | Vaardigheden. Standaard een lege lijst                                                                                                                                          |
| `experiences`                               | lijst           | Werkervaring. Per regel `title`, `company` en optioneel `startDate`, `endDate`, `location` en `description`                                                                     |
| `educations`                                | lijst           | Opleidingen. Per regel `title` en optioneel `institution`, `kind` en `graduationDate`                                                                                           |
| `isAvailable`                               | ja/nee          | Of de kandidaat beschikbaar is. Standaard `true`                                                                                                                                |
| `expectedAvailabilityDate`                  | getal           | Wanneer de kandidaat beschikbaar komt, in milliseconden sinds 1970                                                                                                              |
| `hoursPerWeek`                              | geheel getal    | Gewenst aantal uren per week                                                                                                                                                    |
| `priceLow`, `priceHigh`                     | getal           | Onder- en bovengrens van het uurtarief                                                                                                                                          |
| `contractForms`                             | lijst           | Gewenste contractvormen: `1` zzp, `3` loondienst, `4` tijdelijke arbeidsovereenkomst                                                                                            |
| `offerForm`                                 | getal           | `1` de kandidaat biedt zichzelf aan (standaard), `2` aangeboden via een leverancier                                                                                             |
| `supplier`                                  | object          | Gegevens van de leverancier: `companyName`, `contactName`, `email` en optioneel `phone`                                                                                         |
| `kvkNumber`, `kvkCompanyName`               | tekst           | KvK-nummer en naam van het eigen bedrijf van een zzp'er                                                                                                                         |
| `companyId`                                 | tekst           | Het `_id` van het bedrijf waar de kandidaat bij hoort, bijvoorbeeld de leverancier. Zie [Bedrijf registreren](https://docs.cootje.com/cootje-api/inhuur/bedrijf-registreren.md) |
| `recruiterId`                               | tekst           | Het `_id` van de recruiter, uit `GET /recruiter/recruiters`                                                                                                                     |
| `plannedHolidays`                           | tekst           | Geplande vakanties                                                                                                                                                              |
| `memo`                                      | tekst           | Interne notitie                                                                                                                                                                 |
| `notificationsEnabled`                      | ja/nee          | Of er meldingen over deze kandidaat worden verstuurd. Standaard `true`                                                                                                          |

## Velden die je weglaat

Cootje vult `_id` en `company` zelf. Stuur ze niet mee bij het aanmaken.

## Voorbeeld

```bash
curl -X POST "https://mijn.cootje.com/api/recruiter/candidates" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sanne de Vries",
    "email": "sanne@voorbeeld.nl",
    "title": "Projectleider",
    "skills": [
      "projectmanagement",
      "zorg"
    ],
    "experiences": [
      {
        "title": "Projectleider",
        "company": "Voorbeeld Zorg B.V.",
        "startDate": "2022-01-01"
      }
    ]
  }'
```

## Wat je terugkrijgt

De aangemaakte kandidaat, met het nieuwe `_id`. Velden die je niet hebt meegestuurd, hebben hun standaardwaarde:

```json
{
  "_id": "9e8d7c6b-5a4f-4e3d-a2c1-0a9f8e7d6c5b",
  "name": "Sanne de Vries",
  "companyId": "",
  "company": "",
  "email": "sanne@voorbeeld.nl",
  "zipCode": "",
  "title": "Projectleider",
  "houseNumber": "",
  "city": "",
  "address": "",
  "phone": "",
  "linkedIn": "",
  "isAvailable": true,
  "expectedAvailabilityDate": null,
  "hoursPerWeek": null,
  "plannedHolidays": "",
  "memo": "",
  "recruiterId": "",
  "priceLow": 0,
  "priceHigh": 0,
  "gender": null,
  "skills": [
    "projectmanagement",
    "zorg"
  ],
  "offerForm": 1,
  "supplier": null,
  "contractForms": [],
  "kvkNumber": "",
  "kvkCompanyName": "",
  "experiences": [
    {
      "title": "Projectleider",
      "company": "Voorbeeld Zorg B.V.",
      "companyId": "",
      "startDate": "2022-01-01",
      "endDate": null,
      "location": null,
      "description": null
    }
  ],
  "educations": [],
  "notificationsEnabled": true
}
```

Klopt de invoer niet, dan is het antwoord een lijst met fouten:

```json
[
  {
    "propertyName": "Name",
    "errorMessage": "Naam is verplicht."
  }
]
```

Elke fout bevat daarnaast enkele technische velden, zoals `attemptedValue` en `errorCode`.

## Antwoorden

| Code  | Betekenis                                                 |
| ----- | --------------------------------------------------------- |
| `200` | De aangemaakte kandidaat                                  |
| `400` | De invoer klopt niet. Het antwoord is de lijst met fouten |
| `401` | Geen geldig token, of het account mist het recht          |

Na het aanmaken koppel je de kandidaat aan een vacature met `POST /recruiter/relations`.
