Roles: insert

Requires authorization

Creates a role. Try it now.

Request

HTTP request

POST https://www.googleapis.com/admin/directory/v1/customer/customer/roles

Parameters

Parameter name Value Description
Path parameters
customer string Immutable ID of the G Suite account.

Authorization

This request requires authorization with the following scope (read more about authentication and authorization).

Scope
https://www.googleapis.com/auth/admin.directory.rolemanagement

Request body

In the request body, supply a Roles resource with the following properties:

Property name Value Description Notes
Required Properties
roleName string Name of the role. writable
rolePrivileges[] list The set of privileges that are granted to this role. writable

Response

If successful, this method returns a Roles resource in the response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.