Create a channel

The Create a channel action when triggered creates a channel of any type within a Discord server. It can be referenced in any action or condition throughout your bot's commands and events. All variables and options can be used in the content of all fields within the block.

Variable

The create a channel block also comes with a variable that can be used in later actions or saved in custom variables. This variable can be found at the top of the settings of the block. Here is an example of how it can be used.

Variable	Usage
{channel_id[option_created_channel_abcd]}	This variable will return the ID of the channel. Make sure to replace abcd with the actual 4 unique characters.
{option_created_channel_abcd}	This variable will return the channel mention. Make sure to replace abcd with the actual 4 unique characters.

Name

The name of the channel is what's displayed in the channel list, the top of the channel, and any references of the channel.

Name is not compatible with markdown.

Type

The type of channel defines its function and appearance. You can select from a dropdown that will display the available channel types. Below you can find detailed information about each channel type and how it can be used.

Text Channel

A text channel is a basic channel for Discord users to have text conversations with other server members.

NSFW

This is an optional toggle to choose whether or not to allow NSFW content within the channel. If chosen, the channel will be age restricted to 18+.

Slowmode

This is an optional field, also known as rate limit per user, it allows you to set a slow mode in the created channel for each user unless the user has been bypassed. This field only accepts integers, and variables can be used.

Voice Channel

A voice channel is a interactive channel based of listening and speaking to other users.

User limit

This field represents an optional user limit targeting voice channels only. With a limit in place, only a certain amount of users can be in the voice channel. This field accepts integers only and variables can be used.

Category Channel

The Category Channel is a Category that will be made when this type is selected. Categories can have multiple channels under them and sync permissions as well.

News Channel

A News Channel is a announcement channel that can you publish messages from to followed servers.

Topic

This optional field modifies the topic of the channel. It may be left blank to leave the topic blank. Variables can be used.

Category

Here you can set the ID of the category the channel you're creating is in. You can do this by pasting an ID directly from Discord (learn how here) or using a variable that returns a category ID. These can be easily added through the variable selector by clicking the Clipboard button. You can also leave this field empty to create the channel above all categories.

Optional Server ID

This field is an optional server ID to create the channel in. Leave blank to create the channel in the server the command was triggered in or who clicked a button / menu option. Variables can be used in this field and it must be a plain server ID that is returned.

Permissions

Click the "+" to attach one or more permissions to the channel the bot is editing. Leave this field blank to have default permissions. Visit this link to learn more about permissions. Clicking the button below will allow you to add permissions to the channel.

Role

Selecting this dropdown type will make this permission based off a role. Once selected a new field will appear for you to be able to choose which role from your server to base the permissions off of. You are also able to select role options from this dropdown.

If your role isn't showing, it was most likely recently added. Click the refresh icon to refresh the list of roles to find the role you want.

User

Clicking on the User type will make the bot base the permissions off of a user.

User

In this field you can input a plain user ID or a variable that returns one. User options can also be used.

Enable Success/Error Handles

Enable Success / Error Handles to detect success and errors inside of the action block. This allows you to run different actions if something goes wrong with your action. Inside of the handle, there are 2 different paths which are used to detect the outcome of the action. The green path on the bottom left side of the block indicates success, while the red path on the bottom right side of the block indicates error. You may attach action blocks to each side of the handle to get the outcome of your action block.

The Success/Error Handles feature includes 3 different error variables you can use to get information on why the action block encountered an error. Check them out here.