---
title: "Contacten"
description: "Personen en bedrijven 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.

# Contacten

## Een contact aanmaken

`POST /v1/contacts`

| Veld | Type | Verplicht | Opmerkingen |
| --- | --- | --- | --- |
| `external_id` | string, max 128 | Ja | Je eigen ID voor dit contact. Uniek per klantteam. |
| `name` | string, max 300 | Zie hieronder | Volledige naam van een persoon, of de bedrijfsnaam. |
| `first_name` | string, max 300 | Zie hieronder | Alleen voor personen. |
| `last_name` | string, max 300 | Zie hieronder | Alleen voor personen. |
| `email` | e-mail, max 320 | Nee | |
| `phone` | string, max 50 | Nee | |
| `entity_type` | `person` of `company` | Nee | Standaard `person`. |

Stuur een `name`, of minstens één niet-leeg naamdeel. Stuur je beide, dan winnen de naamdelen en stelt WaW de volledige naam daaruit samen. Een `company` gebruikt alleen `name` en kan geen `first_name` of `last_name` hebben.

```json
{
  "external_id": "person-8421",
  "first_name": "Noor",
  "last_name": "Janssens",
  "email": "noor@example.com",
  "phone": "+32470000001"
}
```

**Antwoord:** `201 Created`

```json
{ "id": "7b0c2f4e-1d2a-4c6b-9e8f-3a5d6c7b8e9f", "external_id": "person-8421" }
```

Stuur je dezelfde aanvraag opnieuw, dan krijg je `200` met dezelfde ID's. Er komt geen dubbel record.

## Een contact bijwerken

`PATCH /v1/contacts/{id}`

Gebruik de WaW-`id` uit het antwoord bij het aanmaken. Je kunt `name`, `first_name`, `last_name`, `email` en `phone` wijzigen. Stuur alleen de velden die je wil wijzigen.

```json
{ "phone": "+32470000002" }
```

**Antwoord:** `200 OK`

```json
{ "id": "7b0c2f4e-1d2a-4c6b-9e8f-3a5d6c7b8e9f", "updated": true }
```

- Velden die je weglaat, blijven zoals ze zijn.
- `null` maakt `email` of `phone` leeg.
- Een nieuwe naam past ook de naam van het contact op de boekingen van de klant aan.

## Goed om te weten

- WaW aanvaardt geen e-mailadres dat een ander contact al gebruikt. Je krijgt dan `422`.
- `external_id` en `entity_type` kunnen na het aanmaken niet meer veranderen.

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