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

# Aanmaken

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

Hiermee maak je een nieuwe vacature aan voor een klant. De vacature is daarna nog niet gepubliceerd.

* **Aanroep:** `POST /recruiter/vacancies`
* **Vereist recht:** Alle vacatures bewerken

## Verplichte velden

| Veld              | Soort        | Toelichting                                                                                                                                              |
| ----------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `companyId`       | tekst        | Het `_id` van de klant. De klant moet al in Cootje staan, zie [Klant registreren](https://docs.cootje.com/cootje-api/klant-inlener/klant-registreren.md) |
| `title`           | tekst        | De titel van de vacature                                                                                                                                 |
| `description`     | tekst        | De omschrijving van de opdracht                                                                                                                          |
| `hoursPerWeek`    | geheel getal | Aantal uren per week, groter dan 0                                                                                                                       |
| `startDate`       | datum        | De startdatum van de opdracht                                                                                                                            |
| `endDate`         | datum        | De einddatum; mag niet voor de startdatum liggen                                                                                                         |
| `closureDateTime` | datum        | Inschrijven kan tot en met dit moment. Een publicatie stopt dan vanzelf                                                                                  |

## Optionele velden

| Veld                             | Soort        | Toelichting                                                                                                                                                                 |
| -------------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `allowedContractForms`           | lijst        | Toegestane contractvormen: `1` zzp, `3` loondienst, `4` tijdelijke arbeidsovereenkomst. Laat je het veld weg, dan zijn alle drie toegestaan. Een lege lijst wordt geweigerd |
| `internalClosureDateTime`        | datum        | De eigen deadline van de recruiter. Standaard één dag na `closureDateTime`; mag daar niet voor liggen                                                                       |
| `hourPrice`                      | getal        | Het inkooptarief per uur. Dit tarief is zichtbaar op de openbare vacaturepagina                                                                                             |
| `salesHourPrice`                 | getal        | Het verkooptarief per uur aan de klant. Alleen intern zichtbaar                                                                                                             |
| `location`                       | tekst        | De plaats waar het werk wordt gedaan                                                                                                                                        |
| `reference`                      | tekst        | Een eigen referentie, bijvoorbeeld het nummer uit je eigen systeem                                                                                                          |
| `expectedOutcome`                | tekst        | Het beoogde resultaat van de opdracht                                                                                                                                       |
| `assignmentRequirements`         | tekst        | De eisen aan de kandidaat                                                                                                                                                   |
| `assignmentRequirementsKnockOut` | ja/nee       | `true` als een kandidaat die niet aan de eisen voldoet afvalt. Standaard `false`                                                                                            |
| `preferredRequirements`          | tekst        | De wensen, naast de eisen                                                                                                                                                   |
| `competencies`                   | tekst        | De gevraagde competenties                                                                                                                                                   |
| `minimumYrsExperience`           | geheel getal | Het minimale aantal jaren ervaring. Standaard 0                                                                                                                             |
| `extensionPossible`              | ja/nee       | `true` als verlenging mogelijk is. Standaard `false`                                                                                                                        |
| `recruiterId`                    | tekst        | Het `_id` van de recruiter, uit `GET /recruiter/recruiters`                                                                                                                 |
| `notificationsEnabled`           | ja/nee       | Of er meldingen over deze vacature worden verstuurd. Standaard `true`                                                                                                       |

Datums zijn tekst in de vorm `2027-03-01T00:00:00`.

## Velden die je weglaat

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

## Voorbeeld

```bash
curl -X POST "https://mijn.cootje.com/api/recruiter/vacancies" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId": "0b7c2f6e-3d1a-4f5b-9a8e-1c2d3e4f5a6b",
    "title": "Projectleider zorg",
    "description": "Leiding geven aan de invoering van een nieuw roostersysteem.",
    "hoursPerWeek": 32,
    "startDate": "2027-03-01T00:00:00",
    "endDate": "2027-08-31T00:00:00",
    "closureDateTime": "2027-02-01T17:00:00"
  }'
```

## Wat je terugkrijgt

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

```json
{
  "_id": "c3d4e5f6-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
  "createdAt": "2027-01-12T09:30:00",
  "companyId": "0b7c2f6e-3d1a-4f5b-9a8e-1c2d3e4f5a6b",
  "company": "Voorbeeld Zorg B.V.",
  "title": "Projectleider zorg",
  "description": "Leiding geven aan de invoering van een nieuw roostersysteem.",
  "expectedOutcome": "",
  "assignmentRequirements": "",
  "assignmentRequirementsKnockOut": false,
  "preferredRequirements": "",
  "competencies": "",
  "location": "",
  "minimumYrsExperience": 0,
  "closureDateTime": "2027-02-01T17:00:00",
  "internalClosureDateTime": "2027-02-02T17:00:00",
  "startDate": "2027-03-01T00:00:00",
  "reference": "",
  "endDate": "2027-08-31T00:00:00",
  "hoursPerWeek": 32,
  "hourPrice": 0,
  "salesHourPrice": 0,
  "allowedContractForms": [
    1,
    3,
    4
  ],
  "extensionPossible": false,
  "recruiterId": "",
  "isCompleted": false,
  "notificationsEnabled": true
}
```

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

```json
[
  {
    "propertyName": "Title",
    "errorMessage": "Titel is verplicht."
  }
]
```

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

## Antwoorden

| Code  | Betekenis                                                 |
| ----- | --------------------------------------------------------- |
| `200` | De aangemaakte vacature                                   |
| `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 is de vacature nog niet zichtbaar voor kandidaten. Dat regel je met [Publiceren en depubliceren](https://docs.cootje.com/cootje-api/recruitment/vacatures/publiceren.md).
