---
title: "Create Channel"
slug: "create-channel"
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 Channel

Post/api/v1/channels.create

Create a public channel. Optionally, include specified users. The channel creator is included as a member by default. Permission required: `create-c`. Channel naming has restraints following the regex filter `[0-9a-zA-Z-_.]+` by default. See [UTF8 Settings](https://docs.rocket.chat/docs/general#utf8) to modify regex filter for channel names. Channel names must not allow for any whitespaces.

### Changelog

| Version | Description |
| --- | --- |
| 6.4.1 | Added `excludeSelf` param |
| 0.13.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='a90535c9-fe51-46a2-bd3d-2b4b863326c5'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='62ac0359-d523-465b-bee0-3f48ba4c5e21'>Example</option>
</select>Example

```json
{
  "name": "channelname",
  "members": [
    "rocket.cat"
  ],
  "readOnly": true,
  "excludeSelf": true,
  "customFields": {
    "type": "default"
  },
  "extraData": {
    "broadcast": true,
    "encrypted": false,
    "teamId": "658441562dd9f928ad9951aa"
  }
}
```

Expand Allobject  namestring    Required

The name of the channel.

members Array of string   

An array of the users to be added to the channel when it is created.

string    
readOnlyboolean    

Set if the channel is read only or not. It is `false` by default.

excludeSelfboolean    

If set to true, the user calling the endpoint is not automatically added as a member of the channel. The default `value` is false.

customFieldsobject  

If you have defined custom fields for your workspace, you can provide them in this object parameter. For details, see the [Custom Fields](https://docs.rocket.chat/docs/custom-fields) document.

extraDataobject  

Enter the following details for the object:

- `broadcast`: Whether the channel should be a broadcast room.
- `encrypted`: Whether the channel should be encrypted.
- `teamId`: Enter an existing team ID for this channel. You need the `create-team-channel` permission to add a team to a channel.

For more information, see [Channels](https://docs.rocket.chat/use-rocket.chat/user-guides/rooms/channels#channel-privacy-and-encryption)

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='b8230112-7d65-43f2-9114-2312e65bb583'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='cd5ac0e9-fe96-4e6f-b5fb-1bba91e7e89a'>Example</option>
</select>Example

```json
{
  "channel": {
    "_id": "ByehQjC44FwMeiLbX",
    "name": "channelname",
    "t": "c",
    "usernames": [
      "example"
    ],
    "msgs": 0,
    "u": {
      "_id": "aobEdbYhXfu5hkeqG",
      "username": "example"
    },
    "ts": "2016-05-30T13:42:25.304Z"
  },
  "success": true
}
```

Expand Allobject  channelobject  _idstring    
fnamestring    
_updatedAtstring    
customFieldsobject  
namestring    
tstring    
msgsinteger    
usersCountinteger    
uobject  _idstring    
usernamestring    
namestring    

tsstring    
roboolean    
defaultboolean    
sysMesboolean    

successboolean    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='68efc463-e971-49c3-b7b3-cc2d2aa4807d'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='fd81aa74-261a-47ac-b0a8-ef2012f540fa'>Authorization Error</option>
</select>Authorization Error

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

object  statusstring    
messagestring