Discord Bot Tools

Discordbot Create Guild Role

Creates a new role in a Discord guild with customizable name, permissions, color, hoist, mentionability, and icon. Requires MANAGE_ROLES permission. The icon and unicode_emoji fields are mutually exclusive.

Write ActionRisk level 2 of 5OAuth connectionFree Action

Use Discordbot Create Guild Role

Owner App

Discord Bot ToolsApp

Required inputs

iconstring

Hash of a custom image for the role's icon. Mutually exclusive with unicode_emoji.

namestring

Name for the new role. If omitted, Discord defaults to 'new role'.

colorinteger

RGB color value for the role as an integer (e.g., red is 16711680). Defaults to 0 (no color).

hoistboolean

If true, displays the role separately in the member list. Defaults to false.

guild_idRequiredstring

The unique identifier (snowflake ID) of the Discord guild where the role will be created.

mentionableboolean

If true, this role can be mentioned by others. Defaults to false.

permissionsstring

Bitwise integer for role permissions combined from Discord permission flags.

unicode_emojistring

Standard Unicode emoji for the role's icon. Mutually exclusive with icon.

Observable output

dataRequired
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulRequiredboolean
Whether or not the action execution was successful or not

Setup and approval

OAuth connection. Risk level 2 of 5.

Pricing and limits

Free Action

Unified payment: Not currently supported

Skills that use this Action

No published Skills explicitly reference this Action yet.

Official source

Provider source