Skip to main content
POST
/
guilds
/
{guild_id}
/
channels
Create guild channel
curl --request POST \
  --url https://api.fluxer.app/v1/guilds/{guild_id}/channels \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": 0,
  "name": "<string>",
  "topic": "<string>",
  "url": "<string>",
  "parent_id": "<string>",
  "bitrate": 164000,
  "user_limit": 49,
  "permission_overwrites": [
    {
      "id": "<string>",
      "type": 0,
      "allow": "<string>",
      "deny": "<string>"
    }
  ],
  "nsfw": true
}
'
{
  "id": "<string>",
  "type": 1073741823,
  "guild_id": "<string>",
  "name": "<string>",
  "topic": "<string>",
  "url": "<string>",
  "icon": "<string>",
  "owner_id": "<string>",
  "position": 1073741823,
  "parent_id": "<string>",
  "bitrate": 1073741823,
  "user_limit": 1073741823,
  "rtc_region": "<string>",
  "last_message_id": "<string>",
  "last_pin_timestamp": "2023-11-07T05:31:56Z",
  "permission_overwrites": [
    {
      "id": "<string>",
      "type": 0,
      "allow": "<string>",
      "deny": "<string>"
    }
  ],
  "recipients": [
    {
      "id": "<string>",
      "username": "<string>",
      "discriminator": "<string>",
      "global_name": "<string>",
      "avatar": "<string>",
      "avatar_color": 1073741823,
      "flags": 1073741823,
      "bot": true,
      "system": true
    }
  ],
  "nsfw": true,
  "rate_limit_per_user": 1073741823,
  "nicks": {}
}

Authorizations

Authorization
string
header
required

Bot token: Authorization: Bot <token>. This is the primary authentication method for bot applications.

Path Parameters

guild_id
string<snowflake>
required

The ID of the guild

Body

application/json
type
enum<integer>
required
Available options:
0
name
string
required

The name of the channel

topic
string | null

The channel topic (1-1024 characters)

url
string | null

External URL for link channels

parent_id
string<snowflake> | null

ID of the parent category for this channel

bitrate
integer<int32> | null

Voice channel bitrate in bits per second (8000-320000)

Required range: 8000 <= x <= 320000
user_limit
integer<int32> | null

Maximum users allowed in voice channel (0-99, 0 means unlimited)

Required range: 0 <= x <= 99
permission_overwrites
object[]

Permission overwrites for roles and members

nsfw
boolean

Whether the channel is marked as NSFW

Response

Success

id
string
required

The unique identifier (snowflake) for this channel

type
integer<int32>
required

The type of the channel

Required range: 0 <= x <= 2147483647
guild_id
string<snowflake>
name
string

The name of the channel

topic
string | null

The topic of the channel

url
string<uri> | null

The URL associated with the channel

icon
string | null

The icon hash of the channel (for group DMs)

owner_id
string<snowflake> | null

The ID of the owner of the channel (for group DMs)

position
integer<int32>
Required range: 0 <= x <= 2147483647
parent_id
string<snowflake> | null

The ID of the parent category for this channel

bitrate
integer<int32> | null

The bitrate of the voice channel in bits per second

Required range: 0 <= x <= 2147483647
user_limit
integer<int32> | null

The maximum number of users allowed in the voice channel

Required range: 0 <= x <= 2147483647
rtc_region
string | null

The voice region ID for the voice channel

last_message_id
string<snowflake> | null

The ID of the last message sent in this channel

last_pin_timestamp
string<date-time> | null

The ISO 8601 timestamp of when the last pinned message was pinned

permission_overwrites
object[]

The permission overwrites for this channel

Maximum array length: 500
recipients
object[]

The recipients of the DM channel

Maximum array length: 25
nsfw
boolean

Whether the channel is marked as NSFW

rate_limit_per_user
integer<int32>
Required range: 0 <= x <= 2147483647
nicks
object

Custom nicknames for users in this channel (for group DMs)