Sign in
Guilds

Create guild role

Create guild role. Requires manage_roles permission. Creates a new role with specified name, permissions, and color.

post/guilds/{guild_id}/roles

Path parameters

string snowflake required
OR
integer required

The ID of the guild

Request body

namestring required

The name of the role (1-100 characters)

colorinteger

Response

Success

idstring snowflake required
namestring required

The name of the role

colorinteger required
positioninteger required
hoist_positioninteger
permissionsstring int64 required

Permission bitfield as string

hoistboolean required

Whether this role is displayed separately in the member list

mentionableboolean required

Whether this role can be mentioned by anyone

unicode_emojistring nullable

The unicode emoji for this role

Changes