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

# Roles & Permissions

Control who can work on tickets, configure Inboxes and manage billing

Access in Suptask is built from two layers that work together:

* **Inbox access** decides which tickets you can work on. You get it by becoming an **Agent** of an Inbox, which happens when you join the Inbox's Responder channel in Slack.
* **Account roles** decide what you can configure. The **Account Admin** and **Billing Admin** roles are given on the [Users & Permissions](https://app.suptask.com/account/users) page in the Web App.

Everyone in your Slack workspace can submit tickets as a **Requester**, without any setup.

Roles add up. A team lead is often an Account Admin and an Agent of their team's Inbox at the same time.

***

### What each role can do

| Permission                                                   | Requester | Agent | Account Admin | Account Admin + Agent | Billing Admin |
| ------------------------------------------------------------ | :-------: | :---: | :-----------: | :-------------------: | :-----------: |
| Submit tickets and view their own tickets                    |     ✓     |   ✓   |       ✓       |           ✓           |       ✓       |
| View, respond to and manage tickets in the Inbox             |     –     |   ✓   |       –       |           ✓           |       –       |
| Dashboard statistics for their Inboxes                       |     –     |   ✓   |       –       |           ✓           |       –       |
| Create new Inboxes                                           |     –     |   –   |       ✓       |           ✓           |       –       |
| Manage the Inbox: Forms, Fields, Intake sources and Settings |     –     |   –   |       –       |           ✓           |       –       |
| Account-wide statistics on the Dashboard                     |     –     |   –   |       ✓       |           ✓           |       –       |
| Account Settings and Users & Permissions                     |     –     |   –   |       ✓       |           ✓           |       –       |
| Subscription & Billing                                       |     –     |   –   |       ✓       |           ✓           |       ✓       |
| Counted as a paid seat                                       |     –     |   ✓   |       –       |           ✓           |       –       |

Agent permissions apply only to the Inboxes where the person is an Agent.

{% hint style="info" %}
The Account Admin role does not give access to every Inbox. To manage an Inbox, or see its tickets, an Account Admin must also be an Agent of that Inbox.

This is important from a privacy perspective as inboxes such as HR is not accessible by an admin, unless they are explicitly invited to it.
{% endhint %}

***

### Agents and Inbox access

An Agent is anyone who is a member of an Inbox's Responder channel in Slack. Membership of the channel and Agent access always match:

* **Join the Responder channel** and you become an Agent of the Inbox.
* **Leave the Responder channel** and you are removed as an Agent.

Every member of the Responder channel becomes an Agent, so only invite people who should work on the Inbox's tickets.

Tickets in an Inbox are only visible to its Agents. This lets you run separate Inboxes for IT, HR and Finance, where each team only sees its own tickets.

#### Automated access

Within your Slack workspace you can give automated access to Suptask by inviting users automatically to the responder channel. This helps with onboarding and offboarding, where these workflows can be set up in Slack.

***

### Add an Agent

You can add an Agent from the Web App or from Slack. Both give the same result: the person joins the Responder channel and becomes an Agent.

**From the Web App**

1. Go to [Inboxes](https://app.suptask.com/inboxes) and open the Inbox
2. Open the **Agents** tab
3. Invite the user

**From Slack**

1. Open the Responder channel of the Inbox
2. Invite the user to the channel, for example by typing `/invite @Ben`

It can take a few minutes before the change shows in Suptask.

{% hint style="info" %}
There is a 6 hour grace period before a new Agent is added to your subscription, so you can remove someone added by mistake without being charged. [Learn more about billing](https://support.suptask.com/account-management/subscription-and-billing.md)
{% endhint %}

***

### Remove an Agent

You can remove an Agent from the Web App or from Slack. Both give the same result: the person leaves the Responder channel and is no longer an Agent.

* **From the Web App:** open the Inbox, go to the **Agents** tab and remove the user
* **From Slack:** remove the user from the Responder channel, for example by typing `/remove @Ben` in the channel

The user loses access to the Inbox and its tickets, and is no longer counted as an Agent. It can take a few minutes before the change shows in Suptask.

***

### Inboxes that share a Responder channel

Several Inboxes can be connected to the same Responder channel. The members of that channel are Agents of **all** the connected Inboxes.

Use a shared Responder channel when the same team should handle tickets from several Inboxes. Use separate Responder channels when different groups of people need different access.

[Learn more about using Inboxes as categories](https://support.suptask.com/setup-and-configure/inboxes/how-to-use-suptask-inboxes#multi-level-categories-with-inboxes-and-forms)

***

### Control who can add Agents

Anyone who can invite people to a Responder channel can make someone an Agent, which also adds a paid seat.

To keep this under control:

* Keep Responder channels **private**
* Use Slack's channel management settings to limit who can invite members to the channel

***

### Account Admin

Account Admins set up and configure Suptask. The role gives access to:

* Account Settings, and Users & Permissions where roles are given
* Subscription & Billing
* Creating new Inboxes
* Account-wide statistics on the Dashboard. Statistics for a single Inbox are only shown to its Agents.
* Inbox configuration (Forms, Fields, Intake sources and Settings), for the Inboxes where they are also an Agent

{% hint style="warning" %}
The Account Admin role applies to the whole Suptask account, not to a single Inbox. An Account Admin can change Account Settings and give roles to other users.
{% endhint %}

**Make someone an Account Admin**

1. Ask the person to log in to the [Suptask Web App](https://app.suptask.com/) once with their Slack account. This registers them in Suptask.
2. Go to [Users & Permissions](https://app.suptask.com/account/users)
3. Find the user and turn on **Account Admin**
4. To let them manage a specific Inbox, also [add them as an Agent](https://support.suptask.com/setup-and-configure/users-and-permissions#add-an-agent) of that Inbox

**If the user is not listed**, check that they have logged in once to the Suptask Web App.

<figure><img src="https://621243658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FO5JbdwXcuzsmDvD73Ccf%2Fuploads%2Fgit-blob-4570e9f551c3100defd99bf5e07b906b5844fccd%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

***

### Let a team lead manage their own Inbox

To let a team lead manage their team's Forms, Fields and Inbox settings:

1. Make them an **Account Admin**
2. Add them as an **Agent** of their team's Inbox

They can now manage their own Inbox and its tickets. They can't see or manage other teams' Inboxes unless they also join those Responder channels.

***

### Billing Admin

Billing Admins manage the Subscription & Billing and receive the receipts. They don't get access to tickets or Inbox configuration.

1. Ask the billing contact to log in to the [Suptask Web App](https://app.suptask.com/) once
2. Go to [Users & Permissions](https://app.suptask.com/account/users)
3. Find the user and turn on **Billing Admin**

You can also complete the checkout with your own user and change the billing contact afterwards. The billing contact and VAT number can be updated from the receipt sent to your email.

***

### Access without being an Agent

Not everyone who takes part in a ticket needs to be an Agent:

* **Requesters** can submit tickets and follow their own tickets in Slack and the Web App.
* **Followers** can follow and comment on a single ticket without access to the Inbox. Any Slack user can be added. [Learn more about Followers](https://support.suptask.com/working-with-tickets/for-agents-who-respond-and-manage-tickets/how-to-add-and-manage-followers-on-tickets)
* **Members of a channel with Public tickets** who are not Agents act as Requesters on those tickets. [Learn more about Users and Agents in the same channel](https://support.suptask.com/setup-and-configure/inboxes/collaboration-with-users-and-agents)

None of these are counted as paid seats.

***

### How access affects billing

Only Agents are counted as paid seats. Account Admins and Billing Admins who are not Agents of any Inbox are not charged for.

An Agent of several Inboxes is counted once.

[Learn more about Subscription & Billing](https://support.suptask.com/account-management/subscription-and-billing/how-does-the-agent-pricing-and-billing-work)

***

### Troubleshooting

**An Inbox is missing in the Web App**

* Check that the user is a member of the Inbox's Responder channel in Slack. Only Agents see the Inbox.
* To manage the Inbox settings and Forms, the user must also be an Account Admin.
* Changes can take a few minutes. To update straight away, reload the Inboxes from the [Inboxes](https://app.suptask.com/inboxes) page.
* If the user is still missing, have them leave and rejoin the Responder channel.

**A user isn't listed on Users & Permissions**

The user must log in to the [Suptask Web App](https://app.suptask.com/) once before they appear in the list.

**Someone became an Agent by mistake**

Remove them from the Agents tab or the Responder channel within 6 hours to avoid being charged.
