---
title: "Create Discussion"
slug: "create-discussion"
updated: 2026-06-08T12:46:40Z
published: 2026-06-08T12:46:40Z
stale: true
---

> ## 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`.

### Changelog

| Version | Description |
| --- | --- |
| 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='f0f88386-32f4-411e-ac33-447b0d33db64'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='f5c8dd53-ff79-4534-9d3d-00d861cec9e5'>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='e88794f1-5d70-4033-a86e-31124bb5ea21'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='a892984a-48d4-4eb4-b79a-7dffdebd2658'>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    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='dc5693a2-05a0-4cef-8def-d32a6d3712a2'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='cb8d899e-93f5-4189-b2a7-0131932a6448'>Authorization Error</option>
</select>Authorization Error

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

object  statusstring    
messagestring