Creating conversations
There are three kinds of conversations you can create: direct messages, groups, and channels. This guide covers how to start each one.
From the New tab
- Open
/conversationsand click the New tab (or go directly to/conversations/new). - Choose the kind:
- Direct message — 1:1 with one other person.
- Group chat — small private chat with 3+ people; invite-only.
- Channel — broader topic-based room, can be public or private to the workspace.
- Fill in the form. Required fields are marked.
- Click Create. You land on the new conversation's detail page.
Quick start a direct message
You don't need to leave the page you're on:
- Use global search (
/) and start typing the person's name. - Click their name; if you already have a DM with them, it opens. If not, a new DM is created instantly with no "Create" button.
- This uses the
getOrCreateDirectConversationmutation under the hood — it is idempotent, so you'll never get duplicate DM threads with the same person.
Required fields by type
| Type | Title | Description | Members | Visibility |
|---|---|---|---|---|
| Direct message | not used | not used | exactly 1 other person | always private |
| Group chat | optional | optional | 2+ other people | always private |
| Channel | required | optional | invite at create time, more later | choose: public, private, protected |
Channel visibility:
- Public — anyone in the workspace can find and join.
- Private — only invited members can find or join.
- Protected — discoverable but join requires approval.
Adding members later
In any conversation header, click Members → Add. Search for users and click to add. You need the participant:add permission, which is granted to Owners, Admins, and Moderators by default.
Initial message (optional)
When creating a conversation, you can include an initial message in the same form. The conversation and the first message are written atomically — if either fails, neither is created.
What happens when you create a conversation
Behind the scenes:
- The conversation row is created with you as Owner.
- A membership row is created for every initial member.
- If you included an initial message, it is created and notifications are sent.
- A real-time event is broadcast to every member's open Conversations view via the event bus.
Next steps
- Direct messages — flow specifics.
- Channels and groups — visibility and discovery.
- Messaging features — what you can do once the conversation exists.