Naar de inhoud

Contacten

Personen en bedrijven aanmaken en bijwerken in het WaW-account van een klant.

Updated Bekijk als markdown

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.
  • 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.
Navigatie

Type to search…

↑↓ navigate↵ selectEsc close