---
title: "Create a new item"
method: POST
path: "/workspaces/notifications"
tags: ["Workspaces - Notifications"]
---

# Create a new item

`POST /workspaces/notifications`

## Request body

- Notification
  - `id` string
  - `userId` string
  - `workspaceId` string
  - `integration` unknown
  - `filters` NotificationFilter[]
    - unknown
  - `eventIds` string[]

## Response `201`

Created

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `429` — Too Many Requests

## Changes

- **2026-07-27** `4b624af2cb6e` — 2 warning, 2 info
  - added the new `MCP_USER_CONNECTED` enum value to the `eventIds/items/` response property for the response status `201`
  - added the new `MCP_USER_RECONNECTED` enum value to the `eventIds/items/` response property for the response status `201`
  - added the new `MCP_USER_CONNECTED` enum value to the request property `eventIds/items/`
  - added the new `MCP_USER_RECONNECTED` enum value to the request property `eventIds/items/`

[Change history](https://skmtc.dev/octoperf/apis/octoperf-api/changes/workspaces/notifications/post.md)

---

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