async def create_role(self, *, reason=None, **fields):
try:<EOL><INDENT>perms = fields.pop('<STR_LIT>')<EOL><DEDENT>except KeyError:<EOL><INDENT>fields['<STR_LIT>'] = <NUM_LIT:0><EOL><DEDENT>else:<EOL><INDENT>fields['<STR_LIT>'] = perms.value<EOL><DEDENT>try:<EOL><INDENT>colour = fields.pop('<STR_LIT>')<EOL><DEDENT>except KeyError:<EOL><INDENT>colour = fields.get('<STR_LIT>', Colour.default())<EOL><DEDENT>finally:<EOL><INDENT>fields['<STR_LIT>'] = colour.value<EOL><DEDENT>valid_keys = ('<STR_LIT:name>', '<STR_LIT>', '<STR_LIT>', '<STR_LIT>', '<STR_LIT>')<EOL>for key in fields:<EOL><INDENT>if key not in valid_keys:<EOL><INDENT>raise InvalidArgument('<STR_LIT>' % key)<EOL><DEDENT><DEDENT>data = await self._state.http.create_role(self.id, reason=reason, **fields)<EOL>role = Role(guild=self, data=data, state=self._state)<EOL>return role<EOL>
|coro|

        Creates a :class:`Role` for the guild.

        All fields are optional.

        You must have the :attr:`~Permissions.manage_roles` permission to
        do this.

        Parameters
        -----------
        name: :class:`str`
            The role name. Defaults to 'new role'.
        permissions: :class:`Permissions`
            The permissions to have. Defaults to no permissions.
        colour: :class:`Colour`
            The colour for the role. Defaults to :meth:`Colour.default`.
            This is aliased to ``color`` as well.
        hoist: :class:`bool`
            Indicates if the role should be shown separately in the member list.
            Defaults to False.
        mentionable: :class:`bool`
            Indicates if the role should be mentionable by others.
            Defaults to False.
        reason: Optional[:class:`str`]
            The reason for creating this role. Shows up on the audit log.

        Raises
        -------
        Forbidden
            You do not have permissions to create the role.
        HTTPException
            Creating the role failed.
        InvalidArgument
            An invalid keyword argument was given.

        Returns
        --------
        :class:`Role`
            The newly created role.