> For the complete documentation index, see [llms.txt](https://support.docstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.docstudio.com/admin-panel/users-and-user-roles/how-to-grant-mailbox-permissions.md).

# ​How to Grant Mailbox Permissions

This document explains how to grant mailbox permissions by selecting a mailbox, choosing the required permissions, and sending an invitation.

Mailbox permissions are granted through roles, just like account permissions. The key difference is that you must select the mailbox the role applies to. Mailbox permissions are granted through roles, just like account permissions. The key difference is that you must select the mailbox that the role applies to.

### Find and filter mailboxes

If the account has many mailboxes, the **Mailbox** tab shows only the 3 most recently created mailboxes. Use search and filters to find the required mailbox instead of scrolling through the full list.

<figure><img src="https://2962383972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoqUiFHjwtCCGSaEDqbXb%2Fuploads%2FpmThbfijOOTAuMn142Jf%2Fimage.png?alt=media&amp;token=7cee7b76-50d4-4eec-b76b-908a7e09d495" alt=""><figcaption></figcaption></figure>

Use the search field to find a mailbox by name. Use the permission status filter next to the search field to switch between these mailbox groups:

* **All** — shows all mailboxes available for permission management.
* **Mailboxes with permissions** — shows mailboxes where the user has at least one permission.
* **Mailboxes without permissions** — shows mailboxes where the user has no permissions.

### Grant mailbox permissions

1. Open the user page in the Admin panel.
2. Go to the **Mailbox** tab.
3. Select the mailbox you want to grant access to.
4. Create a role for the selected mailbox and choose the required permissions.
5. Click **Invite** in the page header.

After you click **Invite**, the system shows a notification in the upper-right corner and sends an invitation email to the user. The next steps depend on whether the user is new or already exists.

To review the full list of permissions, see [Mailbox Permissions](/user/user-access-and-permissions/mailbox-permissions.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://support.docstudio.com/admin-panel/users-and-user-roles/how-to-grant-mailbox-permissions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
