---
title: "Create/Open Conversation"
method: POST
path: "/team-messaging/v1/conversations"
tags: ["Conversations"]
---

# Create/Open Conversation

`POST /team-messaging/v1/conversations`

Creates a new conversation or opens the existing one. If the conversation already exists, then its ID will be returned in response. A conversation is an adhoc discussion between a particular set of users, not featuring any specific name or description; it is a chat of 'Group' type. If you add a person to the existing conversation (group), it creates a whole new conversation.

## Request body

- CreateConversationRequest
  - `members` object[], required — Identifier(s) of chat member(s). The maximum supported number of IDs is 15. User's own ID is optional. If `members` section is omitted then "Personal" chat will be returned
    - `id` string — Internal identifier of a person
    - `email` string, email — Email of a person

## Response `200`

Conversation is opened

- TMConversationInfo
  - `id` string — Internal identifier of a conversation
  - `type` 'Direct' | 'Personal' | 'Group' — Type of conversation
  - `creationTime` string, date-time — Conversation creation datetime in ISO 8601 format
  - `lastModifiedTime` string, date-time — Conversation last change datetime in ISO 8601 format
  - `members` TMChatMemberInfo[]
    - `id` string — Internal identifier of a user

## Other responses

- `201` — Conversation is created
- `400` — Some of the parameters are missing or have invalid format

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)