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.
{
"external_id": "person-8421",
"first_name": "Noor",
"last_name": "Janssens",
"email": "noor@example.com",
"phone": "+32470000001"
}Antwoord: 201 Created
{ "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.
{ "phone": "+32470000002" }Antwoord: 200 OK
{ "id": "7b0c2f4e-1d2a-4c6b-9e8f-3a5d6c7b8e9f", "updated": true }- Velden die je weglaat, blijven zoals ze zijn.
nullmaaktemailofphoneleeg.- 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_idenentity_typekunnen na het aanmaken niet meer veranderen.
