Tenant Roles and Role-Based Access Control¶
Tenant Roles provide centralized control over administrative permissions within Communication Services, letting organizations assign administrative access to users, groups, and service accounts while maintaining governance and security.
About Tenant Roles¶
Tenant Roles are managed centrally and apply across all Communication Services administration features. They let administrators view tenant-level role assignments, assign and update roles, remove role assignments, review current access permissions, and maintain governance and accountability.
Role Types¶
Tenant roles
| Role | Purpose | Typical Responsibilities |
|---|---|---|
| Comms Admin | Communication Services administration and configuration. | • Managing Contact Centers, Email Providers, Mailboxes, and Email Templates • Sending test communications • Monitoring communication activities • Managing Tenant Roles |
| PII Officer | Privacy, governance, and data protection oversight. | • Reviewing communication activities • Supporting privacy compliance initiatives • Monitoring access to sensitive information • Participating in governance processes |
Note: A user, group, or service account may be assigned to one or both roles depending on business requirements.
Accessing Tenant Roles¶
- Navigate to Configurations.
- Select Tenant Roles.
- Review existing role assignments.

Tenant Roles page
The page provides a consolidated view of all administrative role assignments, and includes tenant information, current role assignments, and controls to add, edit, and remove assignments.
Tenant information
| Information | Description |
|---|---|
| Tenant Name | Current tenant |
| Tenant ID | Tenant identifier |
Assigning Roles¶
Tenant Roles are assigned to Users, Groups, or Service Accounts, all shown in a single list, with the Roles column listing every role held (e.g. "Comms Admin" or "Comms Admin | PII Officer").
To create a role assignment:
- Open the Tenant Roles page and select Add Role Assignment.
- Select one or more users, groups, or service accounts.
- Select the required role(s): Comms Admin, PII Officer, or both.
- Save the configuration.

Adding a role assignment
To edit a role assignment: locate the record, select Edit, update the assigned roles, and save.

Tenant roles query and response data shape
To remove a role assignment: select Remove and confirm. Cancel abandons the operation; a failed removal leaves the assignment unchanged.
Read-Only Access¶
Users without sufficient administrative permissions may have read-only access: they can view existing assignments but cannot create, edit, or remove them. The application shows: "You do not have permission to update tenant roles."
Common Administrative Scenarios¶
Assigning a new administrator: open Tenant Roles, select Add Role Assignment, select the user, assign the Comms Admin role, and save — the user then receives access according to organizational policies.
Assigning a group: instead of assigning individual users, assign roles to a group so all members inherit the permissions — giving centralized management, simplified onboarding, and reduced administrative overhead.
Assigning multiple roles: a single user may hold more than one role, allowing them to perform multiple administrative responsibilities.
Error Handling¶
Common scenarios
| Scenario | Behavior |
|---|---|
| Permission denied | Error message displayed |
| Assignment cannot be saved | Changes are not applied |
| Duplicate assignment attempted | Validation message displayed |
| Role information unavailable | Load error displayed |
| Network or service issue | Retry option available |
Best Practices¶
- Apply the principle of least privilege — assign only the permissions required for a user's responsibilities.
- Use groups where possible to simplify administration and reduce maintenance effort.
- Review assignments regularly and remove access no longer required (e.g. when users change roles or leave).
- Separate administrative responsibilities across multiple individuals rather than concentrating all permissions in one user.