> For the complete documentation index, see [llms.txt](https://docs.keeping.com/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeping.com/help/setup/mailbox-permissions.md).

# Mailbox permissions

Choose which tickets each agent can see, what they can do, and whether tickets sync to their Gmail, mailbox by mailbox.

## What are mailbox permissions?

Mailbox permissions let an admin decide, for each agent in each mailbox:

* **Gmail sync:** whether the agent's tickets are copied into their Gmail.
* **Tickets they can see:** every ticket in the mailbox, or only the tickets assigned to them.
* **Actions:** which changes they can make to a ticket, such as replying, assigning or creating share links.

The same agent can have different permissions in different mailboxes. For example, they can see every ticket in Sales and only their own tickets in Support.

{% hint style="info" %}
Restricting what an agent can see and do is an advanced permission, available on plans that include advanced permissions. Gmail sync can be set on every plan. Contact <support@keeping.com> to add advanced permissions to your plan.
{% endhint %}

## Setting an agent's permissions

Only admins can change mailbox permissions.

{% stepper %}
{% step %}

### Open the mailbox

Go to the [mailboxes area](https://app.keeping.com/mailboxes) in Keeping's settings and click the mailbox you want to change.
{% endstep %}

{% step %}

### Find the agent

In the **Agent Permissions** section, tick the agent to give them access to this mailbox. Each ticked agent has a one-line summary of their permissions, such as "Assigned only · Gmail sync off · Can't forward or create share links".
{% endstep %}

{% step %}

### Expand their permissions

Click the agent's summary line to open their permissions and choose the options below. The summary updates as you make changes. Click the **?** for a short explanation of each option.
{% endstep %}

{% step %}

### Save

Click **Save Changes** at the bottom of the page.
{% endstep %}
{% endstepper %}

## The options

### Gmail sync

When Gmail sync is on, the tickets an agent can see are copied into their Gmail inbox, so they can work on them from Gmail with the Keeping extension. When it's off, no new tickets are copied and they work in the [Keeping web Inbox](https://app.keeping.com/tickets) instead. Anything already in their Gmail stays there.

Gmail sync follows what the agent can see: an agent who can only see their assigned tickets only gets their assigned tickets in Gmail. See [Gmail Inbox Sync](https://docs.keeping.com/help/preferences/gmail-inbox-sync.md) for more.

### Tickets they can see

* **All tickets in this mailbox:** every ticket. This is the default.
* **Tickets assigned to them or unassigned:** their own tickets, plus any ticket with no one assigned. Useful for a shared queue that agents pick work up from.
* **Only tickets assigned to them:** just their own tickets, including any they create.

Tickets an agent can't see are hidden everywhere in Keeping: the Inbox, search, counts, notifications, the Chrome extension and Keeping's MCP server. If an agent is unassigned from a ticket they can no longer see, it disappears from their view straight away.

Agents with limited visibility still appear in assignment lists and round robin, since being assigned a ticket is how they get work. Being @mentioned on a ticket they can't see doesn't give them access to it.

### Actions

All actions are on by default. Turn one off to stop the agent doing it in this mailbox:

* **Reply to customers:** send replies from the mailbox.
* **Update status, priority, tags and fields:** change these by hand.
* **Assign and reassign:** assign, reassign or unassign anyone, including themselves.
* **Move to another mailbox:** move a ticket somewhere else.
* **Forward or adjust recipients:** send mail to someone not already on the ticket, by forwarding, adding a CC or BCC, or creating a new outbound ticket.
* **Create public share links:** create or reset a link anyone can open.

Agents can always read the tickets they can see and add internal notes. Mailbox automations, workflows, SLAs and autoresponders still run for every ticket. For example, an agent who can't update status still has tickets closed by the mailbox's "close after reply" setting.

{% hint style="info" %}
When you change an agent from **All tickets** to one of the other options, Keeping also turns off **Forward or adjust recipients** and **Create public share links**. You can turn them back on before you save.
{% endhint %}

{% hint style="warning" %}
Actions are enforced in Keeping: the web Inbox, the Chrome extension, Keeping's MCP server and the API. An agent with Gmail sync on can still reply to or forward a ticket's email directly from Gmail. If an agent must not be able to send mail outside Keeping, turn their Gmail sync off.
{% endhint %}

## Agents you've invited

On plans with advanced permissions, agents you've invited but who haven't joined yet appear on the mailbox page with an **Invited** badge. Set their permissions there before they accept, and they'll start with those permissions on their first sign-in.

## Admins

Admins always have full access to every ticket and action. On the mailbox page their row reads "Admin - full access", and expanding it shows only their Gmail sync setting.

## If your plan doesn't include advanced permissions

Every agent's permissions are shown, but **Tickets they can see** and **Actions** are greyed out and show what applies: all tickets and every action. You can still turn Gmail sync on or off for anyone.

If your plan stops including advanced permissions, the restrictions you set stop applying and those agents can see and do everything again. Keeping remembers the settings, so they apply again if you add advanced permissions back.
