Conversations

Conversations Open

POST
/conversations.open

Opens or resumes a direct message or multi-person direct message.

Authorization

slackAuth channels:write, groups:write, im:write, mpim:write
AuthorizationBearer <token>

In: header

Scope: channels:write, groups:write, im:write, mpim:write

Header Parameters

token?string

Authentication token. Requires scope: conversations:write

Content-Type*"application/x-www-form-urlencoded"

Value in

  • "application/x-www-form-urlencoded"

Request Body

application/x-www-form-urlencoded

channel?string

Resume a conversation by supplying an im or mpim's ID. Or provide the users field instead.

users?string

Comma separated lists of users. If only one user is included, this creates a 1:1 DM. The ordering of the users is preserved whenever a multi-person direct message is returned. Supply a channel when not supplying users.

return_im?boolean

Boolean, indicates you want the full IM channel definition in the response.

Response Body

application/json

application/json

curl -X POST "https://example.com/conversations.open" \  -H "Content-Type: application/x-www-form-urlencoded" \  -H "Content-Type: application/x-www-form-urlencoded" \  -d ''
{  "already_open": true,  "channel": null,  "no_op": true,  "ok": "True"}