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

# POST /notificaties

`POST /notificaties`

## Request

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

Publiceer een notificatie.

## Request body

- Message
  - `kanaal` string, required: De naam van het kanaal (`KANAAL.naam`) waar het bericht op moet worden gepubliceerd.
  - `hoofdObject` string, uri, required: URL-referentie naar het hoofd object van de publicerende API die betrekking heeft op de `resource`.
  - `resource` string, required: De resourcenaam waar de notificatie over gaat.
  - `resourceUrl` string, uri, required: URL-referentie naar de `resource` van de publicerende API.
  - `actie` string, required: De actie die door de publicerende API is gedaan. De publicerende API specificeert de toegestane acties.
  - `aanmaakdatum` string, date-time, required: Datum en tijd waarop de actie heeft plaatsgevonden.
  - `kenmerken` object: Mapping van kenmerken (sleutel/waarde) van de notificatie. De publicerende API specificeert de toegestane kenmerken.

## Response `200`

- Message
  - `kanaal` string, required: De naam van het kanaal (`KANAAL.naam`) waar het bericht op moet worden gepubliceerd.
  - `hoofdObject` string, uri, required: URL-referentie naar het hoofd object van de publicerende API die betrekking heeft op de `resource`.
  - `resource` string, required: De resourcenaam waar de notificatie over gaat.
  - `resourceUrl` string, uri, required: URL-referentie naar de `resource` van de publicerende API.
  - `actie` string, required: De actie die door de publicerende API is gedaan. De publicerende API specificeert de toegestane acties.
  - `aanmaakdatum` string, date-time, required: Datum en tijd waarop de actie heeft plaatsgevonden.
  - `kenmerken` object: Mapping van kenmerken (sleutel/waarde) van de notificatie. De publicerende API specificeert de toegestane kenmerken.

## Changes

- **2019-05-16** `0175e7c33f58`: 2 info
  - 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`
- **2019-04-24** `9befd7b1d2f4`: 1 breaking, 1 info
  - the response property `kenmerken` became optional for the status `200`
  - the request property `kenmerken` became optional

[Operation history](https://skmtc.dev/vng-realisatie/apis/notificaties-api/changes/notificaties/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)