/admin.conversations.create

POST

Create a public or private channel-based conversation.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://slack.com/api/admin.conversations.create' \
--header 'token;' \
--data-urlencode 'is_private=' \
--data-urlencode 'name='

Response Example

200 - response

{
    "channel_id": "C12345",
    "ok": true
}

Request

Header Params

token

string

required

Authentication token. Requires scope: admin.conversations:write

Body Params application/x-www-form-urlencoded

description

string

optional

Description of the public or private channel to create.

is_private

string

required

When true, creates a private channel instead of a public channel

name

string

required

Name of the public or private channel to create.

org_wide

string

optional

When true, the channel will be available org-wide. Note: if the channel is not org_wide=true, you must specify a team_id for this channel

team_id

string

optional

The workspace to create the channel in. Note: this argument is required unless you set org_wide=true.

Responses

🟢200Typical success response

application/json

Body

Schema for successful response of admin.conversations.create

channel_id

string

optional

Match pattern:

^[C][A-Z0-9]{2,}$

enum<boolean>

required

Allowed value:

true

🔴500Typical error response

Modified at 2023-08-15 05:39:45

/admin.conversations.convertToPrivate

/admin.conversations.delete