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

# POST /kanaal

`POST /kanaal`

## Request

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

Maak een KANAAL aan.

## Request body

- Kanaal
  - `url` string, uri: URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `naam` string, required: Naam van het KANAAL (ook wel "Exchange" genoemd) dat de bron vertegenwoordigd.
  - `documentatieLink` string, uri: URL naar documentatie.
  - `filters` string[]: Lijst van mogelijke filter kenmerken van een KANAAL. Deze filter kenmerken kunnen worden gebruikt bij het aanmaken van een ABONNEMENT.

## Response `201`

Created

- Kanaal
  - `url` string, uri: URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `naam` string, required: Naam van het KANAAL (ook wel "Exchange" genoemd) dat de bron vertegenwoordigd.
  - `documentatieLink` string, uri: URL naar documentatie.
  - `filters` string[]: Lijst van mogelijke filter kenmerken van een KANAAL. Deze filter kenmerken kunnen worden gebruikt bij het aanmaken van een ABONNEMENT.

## 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

- **2019-07-17** `9af419381458`: 1 breaking
  - the `url` request property's minLength was increased from `0` to `1`
- **2019-05-16** `0175e7c33f58`: 1 breaking, 3 info
  - removed the required property `invalid-params` from the response with the `400` status
  - the security scope `notificaties.publiceren` was added to the endpoint's security scheme `JWT-Claims`
  - the security scope `notificaties.scopes.publiceren` was removed from the endpoint's security scheme `JWT-Claims`
  - added the required property `invalidParams` to the response with the `400` status

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

---

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