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. |
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. Standaard draft. |
lost_reason |
string, max 1.000, of null |
Nee | Verplicht wanneer status lost is. |
{
"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
{ "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.
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.
{ "location": "Brugge", "status": "confirmed" }Antwoord: 200 OK
{ "id": "3f1e9a2b-5c4d-4e6f-8a7b-9c0d1e2f3a4b", "updated": true }- Velden die je weglaat, blijven zoals ze zijn.
nullmaakt 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.
