Discord

Sends data to Discord

Actions17

Channel → Create

AI-generated

Summary

Create a new channel in a specified Discord server (guild) using Bot Token or OAuth2 authentication. Supports creation of Guild Text, Voice, or Category channels with configurable properties such as name, type, NSFW status, bitrate, parent category, position, rate limits, topic, and user limits.

Inputs

  • authentication (required) — Select the connection type. Choose 'Bot Token' or 'OAuth2' for channel creation operations (Webhook authentication does not support creating channels).
  • guildId (required) — Select the Discord server (guild) where the channel will be created. Can be provided by name, URL, or ID.
  • name (required) — Set the name of the new channel.
  • type (required) — Choose the type of channel to create: Guild Text (0), Guild Voice (2), or Guild Category (4).
  • nsfw — Set whether the text channel is age-restricted (NSFW). Not applicable for category channels.
  • bitrate — Set the bitrate for voice channels (8000 to 96000). Applies only if creating a voice channel.
  • categoryId — Set the parent category channel by name, URL, or ID. Not allowed for category channels themselves.
  • position — Specify the position of the new channel in the channel list.
  • rate_limit_per_user — Set the cooldown in seconds between messages for users in the channel. Applicable to text channels only.
  • topic — Provide a topic description (0-1024 characters) for text channels.
  • user_limit — Set the maximum number of users allowed in a voice channel (0 means no limit). Applicable for voice channels only.

Output shape

a single record representing the newly created channel's details returned from Discord API

The output contains the full Discord channel object as returned by the Discord API, including the configured properties. The operation requires Bot Token or OAuth2 authentication; Webhook authentication cannot be used to create channels.

Examples

Example 1: Create a new text channel named 'announcements' under an existing category in a selected guild with Bot Token authentication.

Set authentication to 'Bot Token', select the target guild, enter 'announcements' as the name, choose 'Guild Text' for type, select the parent category, and optionally set topic and NSFW status.

Example 2: Create a new voice channel with user limit and bitrate.

Choose authentication as 'OAuth2', select guild, enter channel name, choose 'Guild Voice' for type, set 'user_limit' and 'bitrate' values as needed, and optionally specify position and parent category.

Links

Discussion