---
title: "Creates a new channel in Slack."
method: POST
path: "/createChannel"
tags: ["channel"]
---

# Creates a new channel in Slack.

`POST /createChannel`

Creates a new channel in Slack, which can be either public or private.

## Request body

- object
  - `body` object — Body of the createChannel sls call
    - `arguments` object, required
      - `name` string, required — The name of the channel to create.
      - `isPrivate` boolean — Whether the channel should be private. Defaults to false.
      - `join` boolean — Whether the user should join the channel. Defaults to true.
      - `userIds` string[] — Optional array of user IDs to add to the channel after creation. User IDs start with 'U'.

## Response `200`

Successful response

- object
  - `id` string, required — The ID of the channel.
  - `name` string, required — The name of the channel.
  - `is_channel` boolean, required — Indicates if the object represents a channel.
  - `is_group` boolean — Indicates if the object represents a private channel.
  - `is_im` boolean — Indicates if the object represents a direct message conversation.
  - `created` integer, required — A Unix timestamp indicating when the channel was created.
  - `creator` string, required — The ID of the user who created the channel.
  - `is_archived` boolean — Indicates if the channel is archived.
  - `is_general` boolean — Indicates if the channel is the default "general" channel.
  - `unlinked` integer — The number of members that have been removed from the channel
  - `name_normalized` string — The channel name, but with any special characters replaced.
  - `is_shared` boolean — Indicates if the channel is shared with other workspaces.
  - `is_ext_shared` boolean — Indicates if the channel is part of an external shared connection.
  - `is_org_shared` boolean — Indicates if the channel is shared with the entire organization.
  - `pending_shared` string[] — A list of team IDs that have been invited to the channel but have not yet joined
  - `is_pending_ext_shared` boolean — Indicates if the conversation is ready to become an external shared channel but needs approval
  - `is_member` boolean — Indicates if the calling user is a member of the channel.
  - `is_private` boolean, required — Indicates if the channel is private.
  - `is_mpim` boolean — Indicates if the object represents a multi-person direct message.
  - `topic` object — An object containing the channel's topic information.
  - `purpose` object — An object containing the channel's purpose information.
  - `previous_names` unknown[] — A list of any previous names the channel had.
    - unknown
  - `num_members` integer — The number of members in the channel.

## Other responses

- `400` — Bad Request - Invalid parameters provided
- `403` — Forbidden - Not authorized to create channels
- `500` — Internal Server Error

---

[API](https://skmtc.net/microfox-ai/apis/slack-d.md) · [All operations](https://skmtc.net/microfox-ai/apis/slack-d/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/microfox-ai/slack-d/versions/cd0edf0c2cdf/schema)