---
title: "Create a new notification settings"
method: POST
path: "/v5/notifications/settings"
tags: ["Notifications"]
---

# Create a new notification settings

`POST /v5/notifications/settings`

## Request

- Base URL: `https://api.kadoa.com`
- URL: `https://api.kadoa.com/v5/notifications/settings`
- Auth: API key in header `x-api-key`

## Request body

- object
  - `workflowId` string: Workflow ID (optional, if not provided creates workspace-level settings)
  - `eventType` 'workflow_started' | 'workflow_finished' | 'workflow_failed' | 'workflow_sample_finished' | 'workflow_data_change' | 'system_maintenance' | 'service_degradation' | 'credits_low' | 'free_trial_ending', required
  - `eventConfiguration` object, required: Settings specific to the event type. Currently accepts an empty object {}. This object will be extended in future releases to support event-specific configuration options.
  - `enabled` boolean
  - `channelIds` string[]: Array of channel IDs to link to this Settings

## Response `201`

Settings created successfully

- object
  - `data` object
    - `settings` object
      - `id` string
      - `workflowId` string
      - `eventType` string
      - `eventConfiguration` object
      - `enabled` boolean
      - `channels` object[]
        - `id` string
        - `name` string
        - `channelType` string
      - `createdAt` string
      - `updatedAt` string
  - `status` string
  - `message` string

## Other responses

- `400`: Bad request (validation errors or duplicate settings)
- `401`: Unauthorized
- `500`: Internal server error

---

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