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

# Granting Account Permissions

## Permission Granting Options

User accounts can be granted automatically with our [Discord bot](/cad/integration-plugins/discord-bot-integration.md), manually granted by an administrator in your community, or by generating a "[Permission Key](#permission-keys)" for users to access independently.

### [Sonoran CMS - Permission Sync](https://info.sonorancms.com/why-choose-sonoran-cms/why-choose-sonoran-cms)

Sonoran CMS is your single point of management for your community's documents, whitelisting, in-game permissions, community website, and more!

In addition to whitelisting and in-game permissions, [Sonoran CMS can automatically manage your Sonoran CAD permissions](https://info.sonorancms.com/integration-capabilities/sonoran-cad-sync)!

![Sonoran CAD x Sonoran CMS - Permission Sync](/files/m9uepma9rOwKeFd5oVGM)

### Discord Bot Roles

Our [Discord bot](https://info.sonoranbot.com/en/tutorials/getting-started) allows you to automatically sync Discord roles with CAD permissions.

### Manually Granting Permissions

#### 1. Open the Accounts Menu

In the admin menu, select the "Accounts" option to view all user accounts in your community.

{% hint style="info" %}
New and Pending User Accounts

New accounts are automatically set to "PENDING"\
To view pending accounts, you will need to change the accounts drop down in the top left of the window from "Active" to "Pending"
{% endhint %}

![The account grid displays all user accounts in your community](/files/S1FZ19Psi8LK0vKsTkOE)

#### 2. Select an Account

Simply click on an account to manually edit the permissions, ban, or kick a user.\
After changing a user's permissions, don't forget to press save!

![The account management panel allows you to toggle individual user permissions](/files/-M4ptfORTqogpiydhrxT)

### Permission Keys

Permission keys are a great way to allow users to automatically grant themselves their necessary permissions.

#### 1. Create a Permission Key

In the admin menu, select `Accounts > Permission Keys`\
Here, you can create a new permission key. Simply enter the new key name, toggle the associated permissions, and press save.

![Sonoran CAD - Permission Key Editor](/files/-M4puRyLa_QHKgoVlF2x)

#### 2. Apply a Permission Key

At the community menu, your users can enter the new permission key. After pressing enter, the associated permissions will automatically be applied to their account.

![Sonoran CAD - Apply Permission Key](/files/dTlJZIvBy37K76twav17)

{% hint style="info" %}
Invalid Key Error?

Permission keys are *case sensitive*, so ensure your users are entering the key exactly, with the proper capitalization.
{% endhint %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sonoransoftware.com/cad/tutorials/getting-started/permissions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
