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

# Create notification

`POST /notifications`

Create a new notification integration

## Request body

- CreateNotificationRequest
  - `type` 'email' | 'webhook' | 'slack' | 'discord' | 'telegram' | 'zapier', required
  - `name` string, required
  - `config` union — Configuration specific to notification type
    - object
      - `to` string[]
    - object
      - `url` string, uri
      - `headers` object
    - object
      - `webhookUrl` string, uri
      - `channel` string
    - object
      - `webhookUrl` string, uri
  - `isActive` boolean

## Response `201`

Notification created successfully

## Other responses

- `422` — Validation failed
- `500` — Internal server error

## Changes

- **2025-08-11** `db719f9e3d34` — 1 info
  - endpoint added
- **2025-04-20** `b97ec6888b3c` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/bluewave-labs/apis/checkmate-api/changes/notifications/post.md)

---

[API](https://skmtc.dev/bluewave-labs/apis/checkmate-api.md) · [All operations](https://skmtc.dev/bluewave-labs/apis/checkmate-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bluewave-labs/checkmate-api/revisions/8453661342e1/schema)