---
title: "POST /conversations.open"
method: POST
path: "/conversations.open"
tags: ["conversations"]
---

# POST /conversations.open

`POST /conversations.open`

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

## Headers

- `token` string

## Response `200`

Typical success response

- object — Schema for successful response from conversations.open method when opening channels, ims, mpims
  - `already_open` boolean
  - `channel` union[], required
    - union
      - union[]
        - union
          - object
            - `accepted_user` string
            - `connected_team_ids` DefsWorkspaceId[]
            - `conversation_host_id` string
            - `created` integer, required
            - `creator` string, required
            - `display_counts` object
              - …
            - `enterprise_id` string
            - `has_pins` boolean
            - `id` string, required
            - `internal_team_ids` DefsTeam[]
            - `is_archived` boolean, required
            - `is_channel` boolean, required
            - `is_ext_shared` boolean
            - `is_frozen` boolean
            - `is_general` boolean, required
            - `is_global_shared` boolean
            - `is_group` boolean, required
            - `is_im` boolean, required
            - `is_member` boolean
            - `is_moved` integer
            - `is_mpim` false, required
            - `is_non_threadable` boolean
            - `is_open` boolean
            - `is_org_default` boolean
            - `is_org_mandatory` boolean
            - `is_org_shared` boolean, required
            - `is_pending_ext_shared` boolean
            - `is_private` boolean, required
            - `is_read_only` boolean
            - `is_shared` boolean, required
            - `is_starred` boolean
            - `is_thread_only` boolean
            - `last_read` string
            - `latest` union[]
              - …
            - `members` DefsUserId[]
            - `name` string, required
            - `name_normalized` string, required
            - `num_members` integer
            - `parent_conversation` union[]
              - …
            - `pending_connected_team_ids` DefsTeam[]
            - `pending_shared` DefsTeam[]
            - `pin_count` integer
            - `previous_names` DefsChannelName[]
            - `priority` number
            - `purpose` object, required
              - …
            - `shared_team_ids` DefsTeam[]
            - `shares` object[]
              - …
            - `timezone_count` integer
            - `topic` object, required
              - …
            - `unlinked` integer
            - `unread_count` integer
            - `unread_count_display` integer
            - `use_case` string
            - `user` string
            - `version` integer
          - object
            - `accepted_user` string
            - `connected_team_ids` DefsTeam[]
            - `conversation_host_id` string
            - `created` integer, required
            - `creator` string, required
            - `display_counts` object
              - …
            - `id` string, required
            - `internal_team_ids` DefsTeam[]
            - `is_archived` boolean, required
            - `is_channel` boolean, required
            - `is_ext_shared` boolean
            - `is_frozen` boolean
            - `is_general` boolean, required
            - `is_group` boolean, required
            - `is_im` boolean, required
            - `is_member` boolean
            - `is_moved` integer
            - `is_mpim` true, required
            - `is_non_threadable` boolean
            - `is_open` boolean
            - `is_org_shared` boolean, required
            - `is_pending_ext_shared` boolean
            - `is_private` boolean, required
            - `is_read_only` boolean
            - `is_shared` boolean, required
            - `is_starred` boolean
            - `is_thread_only` boolean
            - `last_read` string
            - `latest` union[]
              - …
            - `members` DefsUserId[]
            - `name` string, required
            - `name_normalized` string, required
            - `num_members` integer
            - `parent_conversation` union[]
              - …
            - `pending_connected_team_ids` DefsTeam[]
            - `pending_shared` DefsTeam[]
            - `pin_count` integer
            - `previous_names` DefsChannelName[]
            - `priority` number
            - `purpose` object, required
              - …
            - `shared_team_ids` DefsTeam[]
            - `shares` object[]
              - …
            - `timezone_count` integer
            - `topic` object, required
              - …
            - `unlinked` integer
            - `unread_count` integer
            - `unread_count_display` integer
            - `user` string
            - `version` integer
          - object
            - `created` integer, required
            - `has_pins` boolean
            - `id` string, required
            - `is_archived` boolean
            - `is_ext_shared` boolean
            - `is_frozen` boolean
            - `is_im` boolean, required
            - `is_open` boolean
            - `is_org_shared` boolean, required
            - `is_shared` boolean
            - `is_starred` boolean
            - `is_user_deleted` boolean
            - `last_read` string
            - `latest` union[]
              - …
            - `parent_conversation` union[]
              - …
            - `pin_count` integer
            - `priority` number, required
            - `shares` object[]
              - …
            - `unread_count` integer
            - `unread_count_display` integer
            - `user` string, required
            - `version` integer
      - object
        - `created` string
        - `id` string, required
        - `is_im` boolean
        - `is_open` boolean
        - `last_read` string
        - `latest` ObjsMessage
          - `attachments` object[]
            - `fallback` string
            - `id` integer, required
            - `image_bytes` integer
            - `image_height` integer
            - `image_url` string
            - `image_width` integer
          - `blocks` object[] — This is a very loose definition, in the future, we'll populate this with deeper schema in this definition namespace.
            - `type` string, required
          - `bot_id` union[]
            - union
              - …
          - `bot_profile` ObjsBotProfile
            - `app_id` string, required
            - `deleted` boolean, required
            - `icons` object, required
              - …
            - `id` string, required
            - `name` string, required
            - `team_id` string, required
            - `updated` integer, required
          - `client_msg_id` string
          - `comment` ObjsComment
            - `comment` string, required
            - `created` integer, required
            - `id` string, required
            - `is_intro` boolean, required
            - `is_starred` boolean
            - `num_stars` integer
            - `pinned_info` DefsPinnedInfo
            - `pinned_to` DefsChannel[]
            - `reactions` ObjsReaction[]
              - …
            - `timestamp` integer, required
            - `user` string, required
          - `display_as_bot` boolean
          - `file` ObjsFile
            - `channels` DefsChannelId[]
            - `comments_count` integer
            - `created` integer
            - `date_delete` integer
            - `display_as_bot` boolean
            - `editable` boolean
            - `editor` string
            - `external_id` string
            - `external_type` string
            - `external_url` string, uri
            - `filetype` string
            - `groups` DefsGroupId[]
            - `has_rich_preview` boolean
            - `id` string
            - `image_exif_rotation` integer
            - `ims` DefsDmId[]
            - `is_external` boolean
            - `is_public` boolean
            - `is_starred` boolean
            - `is_tombstoned` boolean
            - `last_editor` string
            - `mimetype` string
            - `mode` string
            - `name` string
            - `non_owner_editable` boolean
            - `num_stars` integer
            - `original_h` integer
            - `original_w` integer
            - `permalink` string, uri
            - `permalink_public` string, uri
            - `pinned_info` DefsPinnedInfo
            - `pinned_to` DefsChannel[]
            - `pretty_type` string
            - `preview` string
            - `public_url_shared` boolean
            - `reactions` ObjsReaction[]
              - …
            - `shares` object
              - …
            - `size` integer
            - `source_team` string
            - `state` string
            - `thumb_1024` string, uri
            - `thumb_1024_h` integer
            - `thumb_1024_w` integer
            - `thumb_160` string, uri
            - `thumb_360` string, uri
            - `thumb_360_h` integer
            - `thumb_360_w` integer
            - `thumb_480` string, uri
            - `thumb_480_h` integer
            - `thumb_480_w` integer
            - `thumb_64` string, uri
            - `thumb_720` string, uri
            - `thumb_720_h` integer
            - `thumb_720_w` integer
            - `thumb_80` string, uri
            - `thumb_800` string, uri
            - `thumb_800_h` integer
            - `thumb_800_w` integer
            - `thumb_960` string, uri
            - `thumb_960_h` integer
            - `thumb_960_w` integer
            - `thumb_tiny` string
            - `timestamp` integer
            - `title` string
            - `updated` integer
            - `url_private` string, uri
            - `url_private_download` string, uri
            - `user` string
            - `user_team` string
            - `username` string
          - `files` ObjsFile[]
            - `channels` DefsChannelId[]
            - `comments_count` integer
            - `created` integer
            - `date_delete` integer
            - `display_as_bot` boolean
            - `editable` boolean
            - `editor` string
            - `external_id` string
            - `external_type` string
            - `external_url` string, uri
            - `filetype` string
            - `groups` DefsGroupId[]
            - `has_rich_preview` boolean
            - `id` string
            - `image_exif_rotation` integer
            - `ims` DefsDmId[]
            - `is_external` boolean
            - `is_public` boolean
            - `is_starred` boolean
            - `is_tombstoned` boolean
            - `last_editor` string
            - `mimetype` string
            - `mode` string
            - `name` string
            - `non_owner_editable` boolean
            - `num_stars` integer
            - `original_h` integer
            - `original_w` integer
            - `permalink` string, uri
            - `permalink_public` string, uri
            - `pinned_info` DefsPinnedInfo
            - `pinned_to` DefsChannel[]
            - `pretty_type` string
            - `preview` string
            - `public_url_shared` boolean
            - `reactions` ObjsReaction[]
              - …
            - `shares` object
              - …
            - `size` integer
            - `source_team` string
            - `state` string
            - `thumb_1024` string, uri
            - `thumb_1024_h` integer
            - `thumb_1024_w` integer
            - `thumb_160` string, uri
            - `thumb_360` string, uri
            - `thumb_360_h` integer
            - `thumb_360_w` integer
            - `thumb_480` string, uri
            - `thumb_480_h` integer
            - `thumb_480_w` integer
            - `thumb_64` string, uri
            - `thumb_720` string, uri
            - `thumb_720_h` integer
            - `thumb_720_w` integer
            - `thumb_80` string, uri
            - `thumb_800` string, uri
            - `thumb_800_h` integer
            - `thumb_800_w` integer
            - `thumb_960` string, uri
            - `thumb_960_h` integer
            - `thumb_960_w` integer
            - `thumb_tiny` string
            - `timestamp` integer
            - `title` string
            - `updated` integer
            - `url_private` string, uri
            - `url_private_download` string, uri
            - `user` string
            - `user_team` string
            - `username` string
          - `icons` object
            - `emoji` string
            - `image_64` string, uri
          - `inviter` string
          - `is_delayed_message` boolean
          - `is_intro` boolean
          - `is_starred` boolean
          - `last_read` string
          - `latest_reply` string
          - `name` string
          - `old_name` string
          - `parent_user_id` string
          - `permalink` string, uri
          - `pinned_to` DefsChannel[]
          - `purpose` string
          - `reactions` ObjsReaction[]
            - `count` integer, required
            - `name` string, required
            - `users` DefsUserId[], required
          - `reply_count` integer
          - `reply_users` DefsUserId[]
          - `reply_users_count` integer
          - `source_team` string
          - `subscribed` boolean
          - `subtype` string
          - `team` string
          - `text` string, required
          - `thread_ts` string
          - `topic` string
          - `ts` string, required
          - `type` string, required
          - `unread_count` integer
          - `upload` boolean
          - `user` string
          - `user_profile` ObjsUserProfileShort
            - `avatar_hash` string, required
            - `display_name` string, required
            - `display_name_normalized` string
            - `first_name` string, nullable, required
            - `image_72` string, uri, required
            - `is_restricted` boolean, required
            - `is_ultra_restricted` boolean, required
            - `name` string, required
            - `real_name` string, required
            - `real_name_normalized` string
            - `team` string, required
          - `user_team` string
          - `username` string
        - `unread_count` number
        - `unread_count_display` number
        - `user` string
  - `no_op` boolean
  - `ok` true, required

## Other responses

- `default` — Typical error response

---

[API](https://skmtc.net/slack/apis/web-api.md) · [All operations](https://skmtc.net/slack/apis/web-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slack/web-api/versions/7b951462b44f/schema)