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

# Roles & Permissions

> Choose what each team member can see and do, with roles like Sales Agent, Support Agent or Manager.

A role is a set of permissions that you assign to team members. Create roles like **Sales Agent**, **Support Agent**, or **Manager**, then assign them to one or more team members. Updating a role automatically updates permissions for everyone using it.

Find it under **Setup → Roles** in the sidebar, or click **Manage Roles** on the **Team & Agents** page.

![The Roles page listing roles with Name, Members and Created columns, an Add Role button, and a row menu](https://docs.chatflows.io/core-setup/img/role.png)

Image shows the Roles page with every role in your workspace.

The table shows each role's **Name**, how many **Members** hold it, and when it was **Created**.

## Create a role

**1. Click Add Role**

The button sits at the top right. A form opens on the right side of the screen.

**2. Name the role**

Enter a role name, such as **Support Agent**.

**3. Check what this role can do**

Select the permissions for the role.

![The Create Role form with a role name field and a list of features with permission checkboxes](https://docs.chatflows.io/core-setup/img/roles-create.png)

Image shows the Create Role form.

**4. Click Save**

The role is ready to assign.

## How the permissions work

Most features offer the same four permissions:

* **View** — see the page and what's on it.
* **Create** — add a new record.
* **Edit** — change an existing record.
* **Delete** — remove a record.

### Permissions that work differently

The role form lists some features by their older names. For example, **Contacts** means Customers, **Channels** means WhatsApp Setup, and **Chat** means **Inbox**.

The table below explains the extra permissions available for each feature.

| Feature | Extra permission |
| - | - |
| **Contacts** | [**Import:**](https://docs.chatflows.io/contacts/import-export.md#importing-contacts) imports contacts from a file. [**Initiate chat:**](https://docs.chatflows.io/contacts/managing-contacts.md#actions-on-a-single-contact) starts a new chat with a contact. **View own:** members see only the contacts assigned to them. |
| **Channels** | [**Connect**](https://docs.chatflows.io/core-setup/channels/whatsapp.md#connecting-whatsapp) and [**Disconnect**](https://docs.chatflows.io/core-setup/channels/messenger.md#managing-a-connected-page) the channels. |
| **Team** | [**Invite:**](https://docs.chatflows.io/core-setup/team-and-roles.md#invite-them-by-email) sends an email invitation. |
| **Templates** | [**Load:**](https://docs.chatflows.io/messaging/whatsapp-templates.md#adding-a-template) pulls your approved templates in from Meta. |
| **WhatsApp Flows** (the [WhatsApp Forms](https://docs.chatflows.io/messaging/whatsapp-forms.md) page) | [**Submission view:**](https://docs.chatflows.io/messaging/whatsapp-forms.md#submissions) members can see customer responses. |
| **Chat** | Works differently — see [Chat](#chat) below. |

### Chat

Chat has no **View** box. A member reaches the inbox if they hold **any** chat permission at all, or if a conversation has been assigned to them.

* **Send Message** — reply in a conversation. Without it, the inbox is read-only.
* **Send Template** — send an approved template.
* **Run Flow** — start an automation or send a form inside a chat.
* **Close** — close the conversation they have open.
* **Clear** — delete every message in a conversation.
* **Delete** — delete a whole conversation.
* **Delete Message** — delete and restore individual messages.

## Admins always have full access

Roles apply only to team members. Team members marked as **Is Admin** always have full access, regardless of the role assigned to them.

> [!WARNING]
>
> A role that members are using cannot be deleted. Move those members to a different role first, then delete it. The **Members** column shows you how many are affected.

## What's next

> [card] [Team & Agents](https://docs.chatflows.io/core-setup/team-and-roles.md)
>
> Add members and give them the roles you have made.

> [card] [Inbox](https://docs.chatflows.io/messaging/live-chat.md)
>
> See how chat permissions play out in the inbox.


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