Sample - Slack Web API
POST/conversations.join

Join a conversation

Joins an existing conversation for the authenticated user. Supply the conversation identifier in channel and use an authentication token with the channels:write scope when authorization is required.

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

1 parameter · 1 body field
tokenstringoptional
Authentication token for the request; it must provide the `channels:write` scope.

Optional form-encoded conversation details.

channelstringoptional
ID of conversation to join

2 status codes
200Returns a success object with `ok` set to true and the joined conversation in `channel`.
channelarrayrequired
okbooleanrequired
Allowed:true
response_metadataobjectoptional
warningstringoptional
defaultTypical error response if the conversation is archived and cannot be joined
callstackstringoptional
Note: PHP callstack is only visible in dev/qa
errorstringrequired
Allowed:method_not_supported_for_channel_typemissing_scopechannel_not_foundis_archivednot_authedinvalid_authaccount_inactiveuser_is_botuser_is_restricteduser_is_ultra_restrictedinvalid_arg_nameinvalid_array_arg
neededstringoptional
okbooleanrequired
Allowed:false
providedstringoptional

Error handling

channel must identify an existing conversation that the authenticated user can join. The token must provide the channels:write scope when supplied for authentication.