---
title: "Create Channel"
method: POST
path: "/api/v1/notifications/channels"
tags: ["channels"]
---

# Create Channel

`POST /api/v1/notifications/channels`

Create notification channel.

Creates a new delivery channel for receiving platform event notifications.
URL must use HTTPS for webhook type. At least one event type must be specified.

## Headers

- `unstructured-api-key` string, nullable

## Request body

- union
  - CreateWebhookChannelRequest — Request to create a webhook notification channel.
    - `channel_type` 'webhook'
    - `description` string, nullable — Channel description
    - `event_types` NotificationEventType[], required — Event types to subscribe to
    - `enabled` boolean — Enable/disable channel
    - `url` string, required — Webhook endpoint URL (HTTPS required)
    - `secret` string, nullable — Consumer-supplied signing secret (24-75 bytes)
  - CreateEmailChannelRequest — Request to create an email notification channel.
    - `channel_type` 'email'
    - `description` string, nullable — Channel description
    - `event_types` NotificationEventType[], required — Event types to subscribe to
    - `enabled` boolean — Enable/disable channel
    - `email_config` EmailChannelConfig, required — User-configurable email settings.
      - `cc` string[], nullable — CC email addresses (if provider supports)
      - `reply_to` string, email, nullable — Reply-to email address
      - `recipient_email` string, email, required — Primary recipient email address

## Response `201`

Successful Response

- union
  - WebhookChannelResponse — Response for webhook notification channel.
    - `channel_type` 'webhook'
    - `id` string, required — Channel ID
    - `description` string, nullable — Channel description
    - `event_types` string[], required — Subscribed event types
    - `enabled` boolean, required — Channel enabled status
    - `created_at` string, date-time, required — Creation timestamp
    - `updated_at` string, date-time, required — Last update timestamp
    - `url` string, required — Webhook endpoint URL
  - EmailChannelResponse — Response for email notification channel.
    - `channel_type` 'email'
    - `id` string, required — Channel ID
    - `description` string, nullable — Channel description
    - `event_types` string[], required — Subscribed event types
    - `enabled` boolean, required — Channel enabled status
    - `created_at` string, date-time, required — Creation timestamp
    - `updated_at` string, date-time, required — Last update timestamp
    - `email_config` EmailChannelConfigResponse, required — Email config in response (no sensitive data).
      - `cc` string[], nullable — CC email addresses (if provider supports)
      - `reply_to` string, email, nullable — Reply-to email address
      - `recipient_email` string, email, required — Primary recipient email address
      - `provider` string, required — Email provider (read-only, from platform config)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/unstructuredapp/apis/platform-api.md) · [All operations](https://skmtc.net/unstructuredapp/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstructuredapp/platform-api/revisions/41676641a27c/schema)