> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# conversations_open

> Open a direct message with one person, or a group message with up to eight. The channel id for a following `chat_post_message` comes back at `channel.id`. Opening the same conversation twice returns the existing one rather than making another.

<div className="tool-route"><span className="tool-row-method" data-method="POST">POST</span><code>{"https://slack.com/api/conversations.open"}</code></div>

```python slack_conversations_open.py theme={null}
from charter.packs import slack

result = await slack.conversations_open.ainvoke({})
```

<Note>
  Requires `chat:write`, `channels:read`, `groups:read`, `im:read`, `mpim:read`, `channels:history`, `groups:history`, `im:history`, `mpim:history`, `users:read`, `reactions:write`.
</Note>

## Body

<div className="reference-table">
  | Field             | Type      | Description                                                                                                                                                    |
  | ----------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `users`           | `string`  | Comma-separated user IDs, between one and eight. One opens a direct message, several open a group one. The caller is always included and should not be listed. |
  | `channel`         | `string`  | Resume an existing conversation by id, instead of naming users.                                                                                                |
  | `returnIm`        | `boolean` | Return the full conversation object rather than just its id.                                                                                                   |
  | `preventCreation` | `boolean` | Check whether the conversation exists without creating one.                                                                                                    |
</div>