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

# Invite and permissions

> Add AuthenticateMe to your server and give it the permissions each feature needs.

## Invite the app

You need the **Manage Server** permission to add an app to a server.

1. Open the [dashboard](https://dashboard.authenticateme.xyz) and sign in with Discord.
2. Your servers are listed in the rail on the left. Servers without AuthenticateMe are greyed out with a **+** badge.
3. Click the server to open Discord's invite screen, then choose **Authorize**.

The **Add to Discord** button on [authenticateme.xyz](https://authenticateme.xyz) works too.

## Permissions

The dashboard invite asks for **Administrator**, which is the simplest way to make sure every feature works. If you'd rather grant permissions one by one, give the AuthenticateMe role the ones below for the features you use.

| Permission | Needed for |
| - | - |
| Manage Roles | Giving the Verified Role and removing the Unverified Role. Without it, AuthenticateMe ignores member joins entirely. |
| View Channel, Send Messages, Embed Links | The verification channel, every logs channel, and the Honeypot channel. |
| Kick Members | Auto Kick and any check whose action is **Kick**. |
| Ban Members | Any check whose action is **Ban** or **Softban**. |
| Timeout Members | The Honeypot **Timeout** action. |
| Create Private Threads, Send Messages in Threads, Manage Threads | The [Help Desk](https://docs.authenticateme.xyz/settings/core.md#help-desk), in the verification channel. |
| Manage Messages | The [Honeypot](https://docs.authenticateme.xyz/settings/account.md#honeypot), which deletes every message posted in its channel. |
| Mention @everyone, @here and All Roles | Alert and Support roles that aren't set to be mentionable. |
| Change Nickname | A custom app name on the [Appearance](https://docs.authenticateme.xyz/dashboard/appearance.md) page. |

> [!TIP]
>
> You don't have to work this out by hand. The [Health](https://docs.authenticateme.xyz/dashboard/health.md) page and the `/health` command list every permission your current settings need and flag the ones that are missing.

## Role position

Discord only lets an app give or remove roles that sit **below** its own highest role, even with Administrator. Open **Server Settings → Roles** and drag the AuthenticateMe role above these roles.

* The Verified Role
* The Unverified Role, if you use one
* The Max Verifications role, if you set one

![The AuthenticateMe role placed above the Verified and Unverified roles in Discord's role list](https://mintcdn.com/authenticate-me/doqmYpEurtBuXylj/images/discord/role-hierarchy-light.webp?fit=max\&auto=format\&n=doqmYpEurtBuXylj\&q=85\&s=b8c0cbcf198ede89447675929d8cce0f)

If the order is wrong, members see "AuthenticateMe's role is too low to give you the role, let the server's staff know" when they try to verify, and the Health page reports the problem.

## Who can configure AuthenticateMe

By default, members with **Manage Server** can open the dashboard and run the setup commands, and members with **Manage Roles** can use the staff commands. Server owners and Administrators always have full access. You can change all of this on the [Permissions](https://docs.authenticateme.xyz/dashboard/permissions.md) page.


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