Sample - Slack Web API
POST/conversations.create

Create a conversation

Creates a public or private channel-based conversation. Provide name for the channel name and set is_private to true when the conversation should be private. The response contains the created conversation object.

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

1 parameter · 2 body fields
tokenstringoptional
Authentication token with the `conversations:write` scope.

Optional conversation creation request containing the channel name and visibility setting.

namestringoptional
Name of the public or private channel to create
is_privatebooleanoptional
Create a private channel instead of a public one

2 status codes
200Returns the created conversation object.
channelarrayrequired
okbooleanrequired
Allowed:true
defaultReturned when the channel name is already in use, the name is invalid, the conversation cannot be created, or authentication or permissions are insufficient.
callstackstringoptional
Note: PHP callstack is only visible in dev/qa
detailstringoptional
errorstringrequired
Allowed:method_not_supported_for_channel_typemissing_scopename_takenrestricted_actionno_channelinvalid_name_requiredinvalid_name_punctuationinvalid_name_maxlengthinvalid_name_specialsinvalid_namenot_authedinvalid_auth
neededstringoptional
okbooleanrequired
Allowed:false
providedstringoptional

Error handling

name must be a valid channel name and must not already be in use. Set is_private to true to create a private conversation; otherwise the conversation is public.