---
title: "Create Channel"
method: POST
path: "/api/realtime/channels"
tags: ["Channels"]
---

# Create Channel

`POST /api/realtime/channels`

Create a new realtime channel with a pattern for subscription matching

## Request body

- CreateChannelRequest
  - `pattern` string, required — Channel pattern for subscription matching. Uses SQL LIKE wildcards, for example "order:%".
  - `description` string — Human-readable description of the channel
  - `webhookUrls` string[] — URLs to receive webhook notifications
  - `enabled` boolean — Whether the channel should be active upon creation

## Response `201`

Channel created successfully

- Channel
  - `id` string, uuid, required — Unique identifier for the channel
  - `pattern` string, required — Channel pattern for subscription matching. Uses SQL LIKE wildcards, for example "order:%".
  - `description` string, nullable — Human-readable description of the channel
  - `webhookUrls` string[], nullable — URLs to receive webhook notifications for messages on this channel
  - `enabled` boolean, required — Whether the channel is currently active
  - `createdAt` string, date-time, required — Timestamp when the channel was created
  - `updatedAt` string, date-time, required — Timestamp when the channel was last updated

## Other responses

- `400` — Invalid input

---

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