> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Role permissions reference

> Every permission you can grant a role in Settings → Roles, with what Read and Write allow. Use it when building a role or checking why someone lacks access.

This page lists every permission in the role editor under **Settings → Roles**, in the order the editor shows them, with what each one lets a member do. Use it to build a least-privilege role or to work out which permission a teammate is missing.

> [!NOTE]
>
> Create and edit roles in **Settings → Roles** in your [OpenCX dashboard](https://platform.open.cx/settings/roles). Editing roles requires the **Roles settings** permission (Write). For creating roles, inherited roles, and directory mappings, see [Roles](https://docs.open.cx/security/roles.md).

## How permissions combine

* **Read and Write.** Most permissions have a **Read** and a **Write** checkbox. Write includes Read: ticking Write ticks Read and locks it. A few permissions are a single action and have only one checkbox.
* **Full admin access.** The **All permissions** checkbox at the top grants every permission on this page. The editor describes it as "Grants every permission below. Use sparingly."
* **The Settings umbrella.** **Settings** (Read) grants Read on every permission nested under it. **Settings** (Write) grants Write on all of them. Permissions outside Settings, such as **Redaction** and **Audit logs**, are never granted by Settings.
* **Nested permissions.** A nested permission is included in its parent. When the parent is ticked, the nested row is ticked and locked.
* **Several roles.** A member with several roles gets every permission any of those roles grants. A member with no roles has no permissions.

![Creating the role Account manager in Settings, Roles, with Contacts read and write permissions](https://mintcdn.com/openchat/hiyaCL2S28Hya6Q7/images/settings/role-create.gif?s=1aa4f4cece379a4e654745841174d5e1)

Create an Account manager role: search the permissions, tick Write on Contacts and Read follows.

In the tables, italic text is the warning the role editor shows under that permission.

## Inbox and sessions

| Permission | Checkboxes | What it allows |
| - | - | - |
| Use all outbound numbers | Write | Use any outbound caller ID. Without this, only numbers allowed for your teams are available. Calling permissions are still required. |
| Hybrid Inbox | Read | Use the calls and chats workspace when enabled. Requires Inbox read access. Listed only when Hybrid Inbox is enabled in **Settings → Voice & Telephony**. |
| Inbox | Read, Write | View and reply to sessions across all channels. Includes **Team sessions** and **Assigned sessions**. |
| Inbox → Team sessions | Read, Write | Work the unassigned sessions waiting in your teams, plus the ones assigned to you. Untick Inbox to limit a role to these. Includes **Assigned sessions**. |
| Inbox → Team sessions → Assigned sessions | Read, Write | Work only the sessions assigned to you. Untick Inbox and Team sessions to limit a role to these. |
| Personal inbox views | Write | Use personal views and custom filters. Saving changes also requires Inbox write access. |
| Shared inbox views | Read, Write | See and manage every filter view shared with the team, including others’. |
| New sessions | Write | Start a brand-new session and send the first message to a customer. *Sends outbound email, WhatsApp, or chat under the org name.* Not included in **Inbox** (Write). |
| Sub-sessions | Write | Branch a linked follow-up session off an existing session. |
| Merge sessions | Write | Permanently close source sessions and link them to a primary session. |
| Delete own messages | Write | Delete your own replies to customers on web chat sessions. The session keeps a deleted marker. *Removes the message from the customer view; cannot be undone.* Also needs write access to sessions. |

## Customers, content, and automation

| Permission | Checkboxes | What it allows |
| - | - | - |
| Contacts | Read, Write | View and manage customer records and history. *Includes personally identifiable information.* |
| Companies | Read, Write | View and manage the companies contacts belong to. *Includes account data synced from your CRM.* |
| Outbound sequences | Read, Write | View and run outbound campaigns. |
| AI knowledge base | Read, Write | View and edit AI training data and behavior. |
| Reports | Read, Write | View analytics dashboards and configure reports. |
| Help center | Read, Write | Run the help center itself: domain, logo, custom CSS and scripts, served languages. Includes its content. |
| Help center content | Read, Write | Write and publish articles and topics, without access to the site’s own settings. |
| Workflows | Read, Write | View and edit automation workflows. Write also allows running them. |
| Run workflows | Read, Write | Manually run or test workflows, without editing them. Read is shared with **Workflows**: ticking it on either row ticks both. |
| Actions | Read, Write | View existing actions and author new ones. |
| Mini apps | Read, Write | View all apps and their source; build, edit, and publish new ones. |
| Companion | Read, Write | Open past Companion chats; run the agent and start new chats. Companion acts as the member using it, so it can't reach anything their other permissions don't allow. |
| Redaction | Read, Write | View PII-redaction settings, and permanently redact message or session content. *Write permanently destroys customer data — cannot be undone.* |
| Voice of Customer | Read, Write | View insights, and merge, edit, or run deep-research on them. |
| Audit logs | Read | View the org audit trail — who changed what, and when. *Reveals actor emails, IPs, and before/after diffs.* |

## Settings permissions

**Settings** itself reads "View and change general workspace settings." Every row below is nested under it.

| Permission | Checkboxes | What it allows |
| - | - | - |
| General | Read, Write | Org profile — name, logo, website — and sandbox environments. |
| Personal profile | Read, Write | Let members change their own display name, photo and customer-facing alias for this workspace. Remove it to have admins manage identities from Members. Part of the default **Member** role. |
| Billing | Read, Write | View plan and invoices, and manage payment methods. *Grants access to financial data.* See [Billing](https://docs.open.cx/billing.md). |
| API keys | Read, Write | View API keys, and create or revoke public-API tokens. *A full-access key can act on the whole workspace.* |
| Autopilot | Read, Write | View and change how the AI autopilot answers sessions. |
| Structured Fields | Read, Write | View and manage typed values and nested choices used by workflows. |
| Webhooks | Read, Write | Configure outbound webhook endpoints, run tests, and view delivery history. Opening the webhook dashboard requires Write. |
| Global variables | Read, Write | Manage org-wide variables and secrets used by actions and workflows. Viewing exposes stored values. |
| Handoff | Read, Write | Configure when and how the AI hands sessions off to human agents. |
| Translations | Read, Write | Enable message translation, set languages, and manage the translator glossary. |
| SSO | Read, Write | View and manage org SSO providers (SAML/OIDC): add, verify domains, and remove. |
| Security | Read, Write | View and change sign-in rules, such as signing teammates out after inactivity. |
| Integrations | Read, Write | Connect, configure, and disconnect ticketing and CRM integrations. *Grants access to stored integration credentials.* |
| Tags | Read, Write | Manage the org tag taxonomy and AI auto-tagging. |
| SLA policies | Read, Write | View and manage SLA policies and targets. |
| Email sending fleet | Read, Write | View sending domains and mailboxes; write allows buying domains and changing fleet settings. |
| CSAT | Read, Write | Configure customer-satisfaction surveys and view scores. |
| Reporting settings | Read, Write | Control how the impact dashboard displays resolution metrics. |
| Office hours | Read, Write | View and change office-hours schedules. |
| Channels settings | Read, Write | View and configure web, email, WhatsApp, SMS, and Slack channels. Includes **Voice & phone**. |
| Channels settings → Voice & phone | Read, Write | Manage phone numbers, SIP trunks, and outbound calling. *Buying numbers and calls incur real spend.* |
| Helpdesk settings | Read, Write | View and change helpdesk defaults that affect agents, including what the Reports & Apps sidebar shows. |
| Custom statuses | Read, Write | Manage custom session status definitions. Statuses stay visible to every inbox agent. |
| Availability statuses | Read, Write | Manage availability status definitions. Agents can always view and apply their own status. |
| Members | Read, Write | Invite and remove teammates, set their availability and capacity, and assign them to teams. Includes **Teams**. |
| Members → Teams | Read, Write | Create and manage teams. A subset of Members, which grants this. |
| Agent availability & capacity | Read, Write | Set other agents' availability status and max concurrent sessions, without inviting or removing members. |
| Roles settings | Read, Write | View and manage permission roles. |
| Roles settings → Directory role mappings | Read, Write | View and manage directory-to-role mappings. Write also grants role editing; role editing alone does not grant mapping access. |
| Macros settings | Read, Write | View and manage macros and variables. |
| Skills settings | Read, Write | View and manage skills used to route sessions to agents. |

**Settings** (Write) also unlocks **Edit customer-facing alias** on other members in [Settings → Members](https://docs.open.cx/ticketing/members.md). No narrower permission grants it.

## Other role settings

The role editor also has three settings that are not permissions.

| Setting | Options | What it does | Default |
| - | - | - | - |
| Teammate call transfers | All teammates, Teammates with this role, Disabled | Controls which teammates agents can transfer calls to. Internal lines and queues remain available. When multiple roles apply, the most permissive setting wins. | All teammates |
| External call transfers | On or off | Allow transfers to phone numbers outside this workspace. Internal lines and queues remain available. Any role that enables this setting grants access; admins retain access. | On |
| Default workspace | Full inbox, Phone Desk, Hybrid Inbox | The workspace agents see when they sign in. Phone Desk requires Phone Desk enabled in Voice & Telephony and session access; a Full inbox role takes priority. Hybrid Inbox is offered only when it is enabled in Voice & Telephony. | Full inbox |

***

## Related Documentation

> [card] [Roles](https://docs.open.cx/security/roles.md)
>
> Create roles and map directory groups.

> [card] [Members](https://docs.open.cx/ticketing/members.md)
>
> Invite people and assign roles.

> [card] [Audit logs](https://docs.open.cx/security/audit-logs.md)
>
> See who changed roles and access.

> [card] [SSO overview](https://docs.open.cx/security/sso/overview.md)
>
> Sign-in and directory provisioning.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.