Skip to main content

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​

  1. Open /conversations and click the New tab (or go directly to /conversations/new).
  2. 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.
  1. Fill in the form. Required fields are marked.
  2. 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 getOrCreateDirectConversation mutation under the hood — it is idempotent, so you'll never get duplicate DM threads with the same person.

Required fields by type​

TypeTitleDescriptionMembersVisibility
Direct messagenot usednot usedexactly 1 other personalways private
Group chatoptionaloptional2+ other peoplealways private
Channelrequiredoptionalinvite at create time, more laterchoose: 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:

  1. The conversation row is created with you as Owner.
  2. A membership row is created for every initial member.
  3. If you included an initial message, it is created and notifications are sent.
  4. A real-time event is broadcast to every member's open Conversations view via the event bus.

Next steps​