---
title: "POST /v1/notification-channels"
method: POST
path: "/v1/notification-channels"
tags: ["NotificationChannel"]
---

# POST /v1/notification-channels

`POST /v1/notification-channels`

## Headers

- `Authorization` string

## Request body

- NotificationChannelCreateInput
  - `data` object, required
    - `name` string, required
    - `type` 'email', required
    - `config` object, required
      - `addresses` string[], required
    - `isDefault` boolean

## Response `201`

Returns the created notification channel

- NotificationChannelOutput
  - `data` object, required
    - `name` string, required
    - `type` 'email', required
    - `config` object, required
      - `addresses` string[], required
    - `isDefault` boolean, required
    - `id` string, uuid, required
    - `userId` string, uuid, required
    - `createdAt` unknown, required
    - `updatedAt` unknown, required

## Other responses

- `400` — Validation error responded when some request parameters are invalid
- `401` — Unauthorized error responded when the user is not authenticated
- `403` — Forbidden error responded when the user is not authorized
- `500` — Internal server error, should probably be reported

## Changes

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

- **2025-08-19** `54647fc87c6d` — 1 info
  - added the new optional request property `data/isDefault`
- **2025-08-15** `98dcb5dcb365` — 1 info
  - added the required property `data/isDefault` to the response with the `201` status
- **2025-06-09** `0cf433a0e3f0` — 1 info
  - endpoint added
- **2025-05-20** `657868531990` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/akash-network/apis/notificationsapi/changes/v1/notification-channels/post.md)

---

[API](https://skmtc.dev/akash-network/apis/notificationsapi.md) · [All operations](https://skmtc.dev/akash-network/apis/notificationsapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/akash-network/notificationsapi/revisions/7c10904298ba/schema)