---
title: "Create notification"
method: POST
path: "/notification"
tags: ["Notifications"]
---

# Create notification

`POST /notification`

Create a notification for the current user. Most notifications are raised by the server from task and workspace events; this exists for integrations. Returns null when the user has turned off this notification category in their preferences.

## Request body

- object
  - `title` string, nullable
  - `message` string, nullable — Stored as the notification's content.
  - `type` string, required
  - `eventData` object, nullable
  - `relatedEntityId` string — Stored as resourceId: the task or workspace being pointed at.
  - `relatedEntityType` string — Stored as resourceType: `task` or `workspace`.

## Other responses

- `400` — Invalid request
- `401` — Missing or invalid credentials

## Changes

- **2026-08-24** `08bbb5bedb5d` — 12 breaking, 3 warning, 3 info
  - the request property `eventData` became not nullable
  - the request property `message` became not nullable
  - the request property `title` became not nullable
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - …14 more
- **2026-07-11** `32cece1ebe43` — 5 breaking, 4 warning, 7 info
  - request body became required
  - the response property `title` became nullable for the status `200`
  - the `createdAt` response's property type/format changed from ``/`` to `string`/`date-time` for status `200`
  - the `resourceType` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - …12 more
- **2026-03-05** `c45ef22a736c` — 1 breaking, 1 info
  - the response property `content` became nullable for the status `200`
  - response property `content` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
- **2026-03-04** `298877d6a79a` — 3 breaking
  - response property `content` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `resourceType` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - the `type` response's property type/format changed from `string`/`` to ``/`` for status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/usekaneo/apis/kaneo-api/changes/notification/post.md)

---

[API](https://skmtc.dev/usekaneo/apis/kaneo-api.md) · [All operations](https://skmtc.dev/usekaneo/apis/kaneo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usekaneo/kaneo-api/revisions/9d1da42c10ce/schema)