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

# Create a channel

`POST /v1/channels`

## Parameters

- `idempotency-key` (header): A unique value (a UUID) for this request. Retrying with the same key within 24 hours returns the first response instead of creating twice.

## Body

- `kind` (required): Channel kind.
- `channelId` (required): A Slack channel id from the connected workspace.
- `channelName` (required): The channel name, for the label.
- `events`: Attention events to receive here, on top of whatever rules send. Omit for none.
- `kind` (required): Channel kind.
- `emails` (required): Each address gets a confirmation link; workspace members are confirmed on sight.
- `events`: Attention events to receive here, on top of whatever rules send. Omit for none.
- `kind` (required): Channel kind.
- `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.
- `events`: Account events to receive at this endpoint (keyword and wallet state changes, attention events), on top of whatever rules send here. Omit for none.

## Responses

- 201: The created channel. A webhook includes its signing secret, shown only here.
- 400: An event this kind of channel cannot receive: Slack, email and Telegram take the attention events only
- 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