---
title: "Create a Slack channel"
method: POST
path: "/integrations/slack/channels"
tags: ["Integrations"]
---

# Create a Slack channel

`POST /integrations/slack/channels`

## Request

- Base URL: `https://api.sazabi.com/v1`
- URL: `https://api.sazabi.com/v1/integrations/slack/channels`
- Auth: none declared
- TypeScript: <https://skmtc.dev/sazabi/apis/sazabi-public-api/docs/integrations/slack/channels/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a public channel in the organization's connected Slack workspace and invite the calling user. Requires the Slack connection to hold the channels:manage bot scope. The new channel appears as an alert destination once the channel catalog refresh completes.

## Request body

- object
  - `organizationId` string: Organization whose connected Slack workspace receives the channel. Auto-filled from CLI and SDK context when omitted.
  - `name` string, required: Channel name. A leading '#' and surrounding whitespace are stripped and the name is normalized to Slack's format (lowercase letters, numbers, hyphens, underscores); the normalized name is limited to 80 characters (Slack's limit).

## Response `201`

OK

- object
  - `id` string, required: Slack channel id ("C...").
  - `name` string, required: Channel name as created, after Slack normalization.
  - `isPrivate` boolean, required: Created channels are always public.
  - `isMember` boolean, required: Whether the Sazabi Slack app is a member of the channel.

## Changes

- **2026-09-18** `bf2ddbe801b3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sazabi/apis/sazabi-public-api/changes/integrations/slack/channels/post.md)

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) - [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sazabi/apis/sazabi-public-api/revisions/dae846531e50?raw)
