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

# POST /abonnement

`POST /abonnement`

Maak een ABONNEMENT aan.

## Request body

- Abonnement
  - `url` string, uri — URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `callbackUrl` string, uri, required — De URL waar notificaties naar toe gestuurd dienen te worden. Deze URL dient uit te komen bij een API die geschikt is om notificaties op te ontvangen.
  - `auth` string, required — Autorisatie header invulling voor het vesturen naar de "Callback URL". Voorbeeld: Bearer a4daa31...
  - `kanalen` FilterGroup[], required — Een lijst van kanalen en filters waarop het ABONNEMENT wordt afgenomen.
    - `filters` object — Map van kenmerken (sleutel/waarde) waarop notificaties gefilterd worden. Alleen notificaties waarvan de kenmerken voldoen aan het filter worden doorgestuurd naar de afnemer van het ABONNEMENT.
    - `naam` string, required — De naam van het KANAAL (`KANAAL.naam`) waarop een abonnement is of wordt genomen.

## Response `201`

Created

- Abonnement
  - `url` string, uri — URL-referentie naar dit object. Dit is de unieke identificatie en locatie van dit object.
  - `callbackUrl` string, uri, required — De URL waar notificaties naar toe gestuurd dienen te worden. Deze URL dient uit te komen bij een API die geschikt is om notificaties op te ontvangen.
  - `auth` string, required — Autorisatie header invulling voor het vesturen naar de "Callback URL". Voorbeeld: Bearer a4daa31...
  - `kanalen` FilterGroup[], required — Een lijst van kanalen en filters waarop het ABONNEMENT wordt afgenomen.
    - `filters` object — Map van kenmerken (sleutel/waarde) waarop notificaties gefilterd worden. Alleen notificaties waarvan de kenmerken voldoen aan het filter worden doorgestuurd naar de afnemer van het ABONNEMENT.
    - `naam` string, required — De naam van het KANAAL (`KANAAL.naam`) waarop een abonnement is of wordt genomen.

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

---

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