---
title: "Boekingen"
description: "Boekingen aanmaken en bijwerken in het WaW-account van een klant."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.withoutaworry.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Boekingen

## Een boeking aanmaken

`POST /v1/bookings`

| Veld | Type | Verplicht | Opmerkingen |
| --- | --- | --- | --- |
| `external_id` | string, max 128 | Ja | Je eigen ID voor deze boeking. Uniek per klantteam. |
| `name` | string, max 300 | Ja | |
| `start_date` | datum-tijd | Ja | Zie [Datums](#datums). |
| `location` | string, max 1.000 | Ja | |
| `end_date` | datum-tijd of `null` | Nee | Moet na `start_date` liggen. |
| `contact_id` | WaW-contact-ID of `null` | Nee | Stelt het hoofdcontact in. Het contact moet in hetzelfde team zitten. |
| `status` | string | Nee | Zie [Statussen](#statussen). Standaard `draft`. |
| `lost_reason` | string, max 1.000, of `null` | Nee | Verplicht wanneer `status` `lost` is. |

```json
{
  "external_id": "booking-8421",
  "name": "Huwelijk Noor en Sam",
  "start_date": "2027-06-12T16:00:00+02:00",
  "end_date": "2027-06-13T02:00:00+02:00",
  "location": "Gent",
  "status": "confirmed"
}
```

**Antwoord:** `201 Created`

```json
{ "id": "3f1e9a2b-5c4d-4e6f-8a7b-9c0d1e2f3a4b", "external_id": "booking-8421" }
```

Stuur je dezelfde aanvraag opnieuw, dan krijg je `200` met dezelfde ID's. Er komt geen dubbel record. Zie [Opnieuw proberen](/nl/partners-api/errors-and-limits#opnieuw-proberen).

## Een boeking bijwerken

`PATCH /v1/bookings/{id}`

Gebruik de WaW-`id` uit het antwoord bij het aanmaken. Stuur alleen de velden die je wil wijzigen. Je kunt elk veld uit de tabel hierboven sturen, behalve `external_id`.

```json
{ "location": "Brugge", "status": "confirmed" }
```

**Antwoord:** `200 OK`

```json
{ "id": "3f1e9a2b-5c4d-4e6f-8a7b-9c0d1e2f3a4b", "updated": true }
```

- Velden die je weglaat, blijven zoals ze zijn.
- `null` maakt een optioneel veld leeg.
- De laatste geslaagde wijziging wint. Past de klant hetzelfde veld aan in WaW, dan overschrijft jouw volgende wijziging het.

## Statussen

WaW heeft drie statussen: `draft` (de standaard), `confirmed` en `lost`. Dat zijn de boekingsstatussen die de klant in WaW ziet.

`lost` heeft een niet-lege `lost_reason` nodig. Zet je een boeking van `lost` naar een andere status, dan wordt de `lost_reason` gewist. `cancelled` is geen geldige status; gebruik `lost` met een reden.

## Datums

Datums volgen RFC 3339, met seconden en een tijdzoneverschil, bijvoorbeeld `2027-06-12T16:00:00+02:00`. Een datum zonder tijd, of een tijd zonder tijdzoneverschil, geeft `422`.

## Goed om te weten

- Maak eerst het contact aan, en geef daarna de WaW-ID mee als `contact_id`.
- Automatisaties die de klant heeft ingesteld voor nieuwe boekingen lopen gewoon.

Source: https://docs.withoutaworry.com/nl/partners-api/bookings/index.mdx
