Skip to main content

Create Channel

Creates a new text or voice channel in a Discord server.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Client Id - The Discord bot client identifier from the Connect node (optional if Bot Token provided).
  • Server Id - The Discord server (guild) ID where the channel will be created.
  • Channel Name - The name for the new channel.

Options​

  • Bot Token - Discord bot token credential (optional if using Client ID from Connect node).
  • Channel Type - The type of channel to create:
    • Text Channel - A standard text channel for messages
    • Voice Channel - A voice channel for audio communication

How It Works​

The Create Channel node creates a new channel in the specified Discord server. When executed, the node:

  1. Authenticates using either Client ID or direct bot token
  2. Validates the server ID and channel name
  3. Determines the channel type (text or voice)
  4. Sends a create channel request to Discord API
  5. Creates the channel with the specified name and type

Requirements​

  • Active Discord bot session (Client ID) or bot token credentials
  • Valid server (guild) ID
  • Manage Channels permission in the target server
  • The bot must be a member of the server

Error Handling​

The node will return specific errors in the following cases:

  • ErrInvalidArg - Client ID or bot token missing/invalid
  • ErrInvalidArg - Server ID is empty
  • ErrInvalidArg - Channel name is empty
  • ErrInvalidArg - Channel type is not selected
  • Discord API errors (missing permissions, server not found, etc.)

Channel Name Rules​

Discord channel names have specific requirements:

  • Must be 1-100 characters long
  • Can only contain lowercase letters, numbers, and hyphens
  • Cannot start or end with a hyphen
  • Spaces are automatically converted to hyphens
  • Special characters are removed

Examples:

  • "general-chat" ✓
  • "support-tickets" ✓
  • "announcements" ✓
  • "voice-lobby" ✓

Example: Create Text Channel​

Inputs:

  • Client Id: (from Connect node)
  • Server Id: "123456789012345678"
  • Channel Name: "bot-commands"
  • Channel Type: "Text Channel"

Result: A new text channel named #bot-commands is created.

Example: Create Voice Channel​

Inputs:

  • Server Id: "123456789012345678"
  • Channel Name: "Music Room"
  • Channel Type: "Voice Channel"
  • Bot Token: (direct credentials)

Result: A new voice channel named "Music Room" is created.

Example: Dynamic Channel Creation​

Create channels based on automation data:

Flow:

1. Get server members
2. For each member role:
   - Create Channel
     - Channel Name: "{{role.name}}-discussion"
     - Channel Type: "Text Channel"

Result: Automatically create role-specific discussion channels.

Use Cases​

  • Event channels - Create temporary channels for events
  • Project management - Auto-create project-specific channels
  • Support tickets - Create dedicated channels for support requests
  • Gaming - Create team channels for gaming sessions
  • Organization - Systematically organize server structure
  • Onboarding - Create personalized channels for new members

Channel Positioning​

By default, newly created channels appear at the bottom of the channel list. To position channels:

  1. Create the channel
  2. Use Discord's channel management to manually position it
  3. Or use category organization to group channels

Permissions​

The created channel inherits the server's default permissions, but you can modify them:

  1. Create the channel with this node
  2. Use Discord's permission settings to customize channel permissions
  3. Or use Discord API directly for programmatic permission management

Bot Permissions Required​

  • Manage Channels - Required to create channels
  • View Channel - To see where the channel is created

Rate Limits​

Discord has rate limits for channel creation:

  • Limit: 50 channels per guild (for most servers)
  • Creating many channels quickly may hit rate limits
  • Consider adding delays between creations in loops

Tips and Best Practices​

  • Naming conventions - Use consistent naming for organization
  • Channel limits - Be aware of Discord's 500 channel limit per server
  • Categories - Organize channels into categories for better structure
  • Cleanup - Delete unused channels to stay organized
  • Permissions - Review default permissions after creation
  • Testing - Test in a development server first
  • Error handling - Handle permission errors gracefully