Skip to main content
POST
/
api
/
servers
/
{serverID}
/
channels
Create a channel
curl --request POST \
  --url http://localhost:8091/api/servers/{serverID}/channels \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "displayName": "<string>",
  "topic": "<string>",
  "isPrivate": false
}
'
{
  "data": {
    "id": "<string>",
    "name": "<string>",
    "displayName": "<string>",
    "topic": "<string>",
    "isDm": true,
    "isPrivate": true,
    "archived": true,
    "createdBy": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "position": 123,
    "serverId": "<string>",
    "memberCount": 123,
    "groupId": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Session token obtained from /api/auth/login or /api/auth/register. Pass as: Authorization: Bearer

Path Parameters

​
serverID
string
required

Server ID

Body

application/json
​
name
string
required

Channel slug name (2-32 chars, lowercased)

Required string length: 2 - 32
​
displayName
string

Human-readable display name (defaults to name)

​
topic
string

Channel topic description

​
isPrivate
boolean
default:false

Whether the channel is private (invite-only)

Response

Channel created

​
data
object