---
title: "Werk een KLANT in zijn geheel bij."
method: PUT
path: "/klanten/{uuid}"
tags: ["klanten"]
---

# Werk een KLANT in zijn geheel bij.

`PUT /klanten/{uuid}`

Werk een KLANT in zijn geheel bij.

## Headers

- `Content-Type` 'application/json', required
- `X-NLX-Logrecord-ID` string
- `X-Audit-Toelichting` string

## Request body

- Klant
  - `url` string, uri — URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `bronorganisatie` string, required — Het RSIN van de Niet-natuurlijk persoon zijnde de organisatie die de klant heeft gecreeerd. Dit moet een geldig RSIN zijn van 9 nummers en voldoen aan https://nl.wikipedia.org/wiki/Burgerservicenummer#11-proef
  - `klantnummer` string, required — De unieke identificatie van de klant binnen de bronorganisatie.
  - `bedrijfsnaam` string — De bedrijfsnaam van de klant.
  - `functie` string — De functie van de klant.
  - `websiteUrl` string, uri, required — Het label of etiket dat aan de specifieke informatiebron, zoals een webpagina, een bestand of een plaatje op internet is toegewezen waar de KLANT in de regel op het internet vindbaar is.
  - `voornaam` string — De voornaam, voorletters of roepnaam van de klant.
  - `voorvoegselAchternaam` string — Het voorvoegsel van de achternaam van de klant.
  - `achternaam` string — De achternaam van de klant.
  - `telefoonnummer` string — Het mobiele of vaste telefoonnummer van de klant.
  - `emailadres` string, email — Het e-mail adres van de klant.
  - `voorkeurskanaal` string — Het communicatiekanaal dat de voorkeur heeft van de KLANT. Deze voorkeur is default maar kan overruled worden in een specifieke klantinteractie.
  - `voorkeurstaal` string — Een ISO 639-2/B taalcode waarin de voorkeurstaal van de klant voor interacties met de gemeente is vastgelegd. Zie: https://www.iso.org/standard/4767.html. Deze voorkeur is default maar kan overruled worden in een specifieke klantinteractie.
  - `adres` KlantAdres, nullable — Adresgegevens zoals opgegeven door de klant (kan ook een buitenlandsadres zijn)
    - `straatnaam` string
    - `huisnummer` integer, nullable
    - `huisletter` string
    - `huisnummertoevoeging` string
    - `postcode` string
    - `woonplaatsnaam` string
    - `landcode` string — De code, behorende bij de landnaam, zoals opgenomen in de Land/Gebied-tabel van de BRP.
  - `subject` string, uri — URL-referentie naar een subject
  - `subjectType` 'natuurlijk_persoon' | 'niet_natuurlijk_persoon' | 'vestiging', nullable — Type van de `subject`. Uitleg bij mogelijke waarden: * `natuurlijk_persoon` - Natuurlijk persoon * `niet_natuurlijk_persoon` - Niet-natuurlijk persoon * `vestiging` - Vestiging

## Response `200`

OK

- Klant
  - `url` string, uri — URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `bronorganisatie` string, required — Het RSIN van de Niet-natuurlijk persoon zijnde de organisatie die de klant heeft gecreeerd. Dit moet een geldig RSIN zijn van 9 nummers en voldoen aan https://nl.wikipedia.org/wiki/Burgerservicenummer#11-proef
  - `klantnummer` string, required — De unieke identificatie van de klant binnen de bronorganisatie.
  - `bedrijfsnaam` string — De bedrijfsnaam van de klant.
  - `functie` string — De functie van de klant.
  - `websiteUrl` string, uri, required — Het label of etiket dat aan de specifieke informatiebron, zoals een webpagina, een bestand of een plaatje op internet is toegewezen waar de KLANT in de regel op het internet vindbaar is.
  - `voornaam` string — De voornaam, voorletters of roepnaam van de klant.
  - `voorvoegselAchternaam` string — Het voorvoegsel van de achternaam van de klant.
  - `achternaam` string — De achternaam van de klant.
  - `telefoonnummer` string — Het mobiele of vaste telefoonnummer van de klant.
  - `emailadres` string, email — Het e-mail adres van de klant.
  - `voorkeurskanaal` string — Het communicatiekanaal dat de voorkeur heeft van de KLANT. Deze voorkeur is default maar kan overruled worden in een specifieke klantinteractie.
  - `voorkeurstaal` string — Een ISO 639-2/B taalcode waarin de voorkeurstaal van de klant voor interacties met de gemeente is vastgelegd. Zie: https://www.iso.org/standard/4767.html. Deze voorkeur is default maar kan overruled worden in een specifieke klantinteractie.
  - `adres` KlantAdres, nullable — Adresgegevens zoals opgegeven door de klant (kan ook een buitenlandsadres zijn)
    - `straatnaam` string
    - `huisnummer` integer, nullable
    - `huisletter` string
    - `huisnummertoevoeging` string
    - `postcode` string
    - `woonplaatsnaam` string
    - `landcode` string — De code, behorende bij de landnaam, zoals opgenomen in de Land/Gebied-tabel van de BRP.
  - `subject` string, uri — URL-referentie naar een subject
  - `subjectType` 'natuurlijk_persoon' | 'niet_natuurlijk_persoon' | 'vestiging', nullable — Type van de `subject`. Uitleg bij mogelijke waarden: * `natuurlijk_persoon` - Natuurlijk persoon * `niet_natuurlijk_persoon` - Niet-natuurlijk persoon * `vestiging` - Vestiging

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `406` — Not acceptable
- `409` — Conflict
- `410` — Gone
- `415` — Unsupported media type
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.net/vng-realisatie/apis/klanten-api.md) · [All operations](https://skmtc.net/vng-realisatie/apis/klanten-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vng-realisatie/klanten-api/versions/b39d49ff7bdc/schema)