---
title: "POST /klantverzoeken"
method: POST
path: "/klantverzoeken"
tags: ["klantverzoeken"]
---

# POST /klantverzoeken

`POST /klantverzoeken`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/klantverzoeken`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/vng-realisatie/apis/verzoeken-api/docs/klantverzoeken/post.ts> (a function with typed inputs; its response is checked against the schema)

Maak een KLANT-VERZOEK relatie aan.

## Headers

- `Content-Type` 'application/json', required
- `X-NLX-Request-Application-Id` string
- `X-NLX-Request-User-Id` string
- `X-Audit-Toelichting` string

## Request body

- KlantVerzoek
  - `url` string, uri: URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `klant` string, uri, required: URL-referentie naar een KLANT (in Klanten API)
  - `verzoek` string, uri, required: URL-referentie naar het VERZOEK.
  - `rol` 'belanghebbende' | 'initiator' | 'mede_initiator': Rol van de KLANT bij het VERZOEK. Uitleg bij mogelijke waarden: * `belanghebbende` - Belanghebbende * `initiator` - Initiator * `mede_initiator` - Mede-initiator
  - `indicatieMachtiging` 'gemachtigde' | 'machtiginggever': Indicatie machtiging Uitleg bij mogelijke waarden: * `gemachtigde` - (Gemachtigde) De KLANT is door een andere KLANT gemachtigd om in het VERZOEK namens hem of haar te handelen. * `machtiginggever` - (Machtiginggever) De KLANT heeft een andere KLANT gemachtigd om in het VERZOEK namens hem of haar te handelen.

## Response `201`

Created

- KlantVerzoek
  - `url` string, uri: URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `klant` string, uri, required: URL-referentie naar een KLANT (in Klanten API)
  - `verzoek` string, uri, required: URL-referentie naar het VERZOEK.
  - `rol` 'belanghebbende' | 'initiator' | 'mede_initiator': Rol van de KLANT bij het VERZOEK. Uitleg bij mogelijke waarden: * `belanghebbende` - Belanghebbende * `initiator` - Initiator * `mede_initiator` - Mede-initiator
  - `indicatieMachtiging` 'gemachtigde' | 'machtiginggever': Indicatie machtiging Uitleg bij mogelijke waarden: * `gemachtigde` - (Gemachtigde) De KLANT is door een andere KLANT gemachtigd om in het VERZOEK namens hem of haar te handelen. * `machtiginggever` - (Machtiginggever) De KLANT heeft een andere KLANT gemachtigd om in het VERZOEK namens hem of haar te handelen.

## Other responses

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

## Changes

> 9 revisions in range; 1 not diffed.

- **2022-06-13** `1f46a04e9dae`: 2 breaking, 1 warning, 5 info
  - added the new required `header` request parameter `Content-Type`
  - removed the enum value `mede-initiator` of the request property `rol`
  - added the new `mede_initiator` enum value to the `rol` response property for the response status `201`
  - added the new optional `header` request parameter `X-Audit-Toelichting`
  - …4 more
- **2020-07-09** `a7cd30866623`: 1 warning
  - deleted the `header` request parameter `Content-Type`
- **2020-07-09** `d63999b3259d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vng-realisatie/apis/verzoeken-api/changes/klantverzoeken/post.md)

---

[API](https://skmtc.dev/vng-realisatie/apis/verzoeken-api.md) - [All operations](https://skmtc.dev/vng-realisatie/apis/verzoeken-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vng-realisatie/apis/verzoeken-api/revisions/1f46a04e9dae?raw)