---
title: "Create a channel"
canonical: https://docs.mentio.dev/api/alerts/create-channel
markdown: https://docs.mentio.dev/api/alerts/create-channel.mdx
---

# Create a channel

`POST /v1/channels`

## Body

- `kind` (required): string
- `channelId` (required): A Slack channel id from the connected workspace.
- `channelName` (required): The channel name, for the label.
- `kind` (required): string
- `emails` (required): Each address gets a confirmation link; workspace members are confirmed on sight.
- `kind` (required): string
- `url` (required): Where the signed POSTs go. https in production.
- `label`: A name for the channel; the host of the URL when omitted.
- `headers`: Extra request headers to send, for your own auth.

## Responses

- 201: The created channel. A webhook includes its signing secret, shown only here.
- 401: Missing or invalid API key
- 409: Slack is not connected for this org

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx