---
title: "Create Notifications Setting"
method: POST
path: "/notifications/settings"
tags: ["Notification Settings"]
---

# Create Notifications Setting

`POST /notifications/settings`

Create a new item

## Request body

- CreateNotificationsSettingInput
  - `data` ModelsNotificationSetting, required — The data to update
    - `_id` string, objectid — ID
    - `channel_ids` string[] — Channel IDs
    - `created_at` string, date-time — Created timestamp
    - `created_by` string, objectid — Created by
    - `description` string — Description
    - `enabled` boolean — Enabled
    - `mail_bcc` string[] — Mail BCC
    - `mail_cc` string[] — Mail CC
    - `mail_to` string[] — Mail to
    - `name` string — Name
    - `sender_email` string — Sender email
    - `sender_name` string — Sender name
    - `task_trigger` string — Task trigger
    - `template` string — Template
    - `template_markdown` string — Template markdown
    - `template_mode` string — Template mode
    - `template_rich_text` string — Template rich text
    - `template_rich_text_json` string — Template rich text JSON
    - `template_theme` string — Template theme
    - `title` string — Title
    - `trigger` string — Trigger
    - `updated_at` string, date-time — Updated timestamp
    - `updated_by` string, objectid — Updated by
    - `use_custom_sender_email` boolean — Use custom sender email

## Response `200`

OK

- ControllersResponseGithubModelsNotificationSetting
  - `data` ModelsNotificationSetting — The data to update
    - `_id` string, objectid — ID
    - `channel_ids` string[] — Channel IDs
    - `created_at` string, date-time — Created timestamp
    - `created_by` string, objectid — Created by
    - `description` string — Description
    - `enabled` boolean — Enabled
    - `mail_bcc` string[] — Mail BCC
    - `mail_cc` string[] — Mail CC
    - `mail_to` string[] — Mail to
    - `name` string — Name
    - `sender_email` string — Sender email
    - `sender_name` string — Sender name
    - `task_trigger` string — Task trigger
    - `template` string — Template
    - `template_markdown` string — Template markdown
    - `template_mode` string — Template mode
    - `template_rich_text` string — Template rich text
    - `template_rich_text_json` string — Template rich text JSON
    - `template_theme` string — Template theme
    - `title` string — Title
    - `trigger` string — Trigger
    - `updated_at` string, date-time — Updated timestamp
    - `updated_by` string, objectid — Updated by
    - `use_custom_sender_email` boolean — Use custom sender email
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

## Changes

> 3 revisions in range; 1 could not be searched.

- **2025-03-03** `14e4eafea538` — 12 warning
  - removed the request property `_id`
  - removed the request property `channel_id`
  - removed the request property `created_at`
  - removed the request property `created_by`
  - …8 more
- **2025-03-02** `526e5bdf6dee` — 1 breaking, 27 warning, 18 info
  - request body became required
  - removed the request property `data`
  - removed the optional property `data/_id` from the response with the `200` status
  - removed the optional property `data/channel_ids` from the response with the `200` status
  - …42 more

[Change history](https://skmtc.dev/crawlab-team/apis/crawlab-api/changes/notifications/settings/post.md)

---

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