POST /conversations.open

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

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/x-www-form-urlencoded"

token String No

Authentication token. Requires scope: conversations:write

Request body fields

Name Type Required Description
channel String No

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

return_im Boolean No

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

users String No

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.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.