---
title: "Create Discussion"
slug: "create-discussion"
status: "update"
updated: 2026-09-15T14:09:32Z
published: 2026-09-15T14:09:32Z
canonical: "developer.rocket.chat/create-discussion"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Discussion

Post/api/v1/rooms.createDiscussion

Creates a new discussion for the room. It requires at least one of the following permissions: `start-discussion` OR `start-discussion-other-user`, AND must be with the following setting enabled: `Discussion_enabled`.

When **Force end-to-end encryption on private rooms** is enabled, you cannot create a discussion under an unencrypted private room. Make the parent room public or enable encryption on it before creating the discussion.

### Changelog

| Version | Description |
| --- | --- |
| 8.8.0 | Added forced encryption checks for private-room discussions. |
| 1.0.0 | Added |

Header parametersX-Auth-TokenstringRequired

The `authToken` of the authenticated user.

ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-IdstringRequired

The `userId` of the authenticated user.

ExamplerbAXPnMktTFbNpwtJ

Body parameters<select class='api-response-data' aria-label='Media type'><option value='0e56e76c-23eb-45f5-89f7-6428ec53afe6'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='58deef80-8fcc-4a06-8c0c-4df3e00df2e3'>Example</option>
</select>Example

```json
{
  "prid": "GENERAL",
  "t_name": "Discussion Name"
}
```

object  pridstring    Required

Parent room ID of the discussion.

t_namestring    Required

Discussion name.

users Array of string   

Array of users to join in the discussion, if not provided, it will be an empty array. (Note: if provided, it must be an array).

string    
pmidstring    

Parent message ID (if the discussion comes from a message).

replystring    

The reply of the discussion.

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='414f9093-bbac-4a0e-97df-588f58c68335'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='0cbf1955-81c1-45b5-b7a2-0375679ec326'>Success</option>
</select>Success

```json
{
  "discussion": {
    "rid": "cgk88DHLHexwMaFWh",
    "name": "WJNEAM7W45wRYitHo",
    "fname": "Discussion Name",
    "t": "p",
    "msgs": 0,
    "usersCount": 0,
    "u": {
      "_id": "rocketchat.internal.admin.test",
      "username": "rocketchat.internal.admin.test"
    },
    "topic": "general",
    "prid": "GENERAL",
    "ts": "2019-04-03T01:35:32.271Z",
    "ro": false,
    "sysMes": true,
    "default": false,
    "_updatedAt": "2019-04-03T01:35:32.280Z",
    "_id": "cgk88DHLHexwMaFWh"
  },
  "success": true
}
```

Expand Allobject  discussionobject  ridstring    
namestring    
fnamestring    
tstring    
msgsinteger    
usersCountinteger    
uobject  _idstring    
usernamestring    

topicstring    
pridstring    
tsstring    
roboolean    
sysMesboolean    
defaultboolean    
_updatedAtstring    
_idstring    

successboolean    

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='dad8fd88-bcfd-4857-ac49-672b6c8f1fdf'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='614079c8-dc34-43de-8cf2-d192b79aaf79'>Private room encryption is enforced</option>
</select>Private room encryption is enforced

```json
{
  "success": false,
  "error": "Workspace policy requires all private rooms to be encrypted. To create this discussion, make the parent channel public or enable encryption on it. [error-encrypted-private-rooms-enforced-discussion]",
  "errorType": "error-encrypted-private-rooms-enforced-discussion"
}
```

object  successboolean    
errorstring    
errorTypestring    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='230d3d6c-42ee-4a7d-b448-d0cc3dc2cd97'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='d9ec97c8-d5af-4a21-814a-9dccc8e5f0ad'>Authorization Error</option>
</select>Authorization Error

```json
{
  "status": "error",
  "message": "You must be logged in to do this."
}
```

object  statusstring    
messagestring