Sample - Slack Web API
POST/admin.conversations.create

Create a channel-based conversation

Creates a public or private channel-based conversation. Supply name and is_private, and provide team_id unless org_wide is true; the response includes the new channel identifier.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 5 body fields
tokenstringrequired
Authentication token with the `admin.conversations:write` scope.

Form-encoded channel creation details. name and is_private are required.

namestringrequired
Name of the public or private channel to create.
descriptionstringoptional
Description of the public or private channel to create.
is_privatebooleanrequired
When `true`, creates a private channel instead of a public channel
org_widebooleanoptional
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_idstringoptional
The workspace to create the channel in. Note: this argument is required unless you set `org_wide=true`.

2 status codes
200Returns `ok` set to true and the created channel's `channel_id`.
channel_idstringoptional
okbooleanrequired
Allowed:true
defaultReturns an object with `ok` set to false and an `error` value describing why the channel could not be created.
errorstringrequired
Allowed:feature_not_enabledname_takenrestricted_actionteam_not_foundinvalid_teaminvalid_namecould_not_create_channelteam_id_or_org_required
okbooleanrequired
Allowed:false

Error handling

The token must carry the admin.conversations:write scope. name and is_private are required, and team_id must be provided unless org_wide is true.