---
title: "Create notification"
method: POST
path: "/api/{workspaceId}/config/notification"
tags: ["Notification channels"]
---

# Create notification

`POST /api/{workspaceId}/config/notification`

## Request

- Base URL: `https://use.jitsu.com`
- URL: `https://use.jitsu.com/api/{workspaceId}/config/notification`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, required

## Request body

- NotificationChannel: Subscription that delivers workspace alerts (sync failures, batch failures, dead-letter events) to email or Slack.
  - `id` string, required
  - `type` string, required
  - `workspaceId` string, required
  - `name` string, required
  - `updatedAt` string, nullable
  - `cloneId` string
  - `events` string[]
  - `channel` 'email' | 'slack'
  - `slackWebhookUrl` string
  - `emails` string[]
  - `recurringAlertsPeriodHours` number
  - `summarizeBatchNotificationsByTable` boolean

## Response `200`

OK

- object
  - `id` string, required

## Other responses

- `400`: Bad request
- `401`: Authorization required
- `403`: Forbidden — no access to this workspace, or the workspace's plan does not include this feature
- `500`: Internal server error

---

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