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

# Scopes

> OAuth permissions — same scopes as API keys, approved by the user on the consent screen.

<Tip>
  A **scope** defines what the token can do. Ask for the minimum — the user sees the full list before approving.
</Tip>

## How scopes work in OAuth

You declare scopes at **two points**:

1. **Client registration** — app defaults (dashboard or `POST /oauth/register`)
2. **Authorization** — what you request for that login (`scope` on `/oauth/authorize`)

The token only works on endpoints the scope allows — **same as API keys**.

## List by channel

| Channel    | Guide                                                                      |
| ---------- | -------------------------------------------------------------------------- |
| Email      | [Email scopes](/en/emails-api/como-funciona/escopos-da-api-key)            |
| WhatsApp   | [WhatsApp scopes](/en/whatsapp-api/como-funciona/escopos-api-key)          |
| SMS        | [SMS scopes](/en/sms-api/como-funciona/escopos-da-api-key)                 |
| Contacts   | [Contacts scopes](/en/contacts-api/como-funciona/escopos-da-api-key)       |
| Webhooks   | `webhooks:read`, `webhooks:manage` — [Webhooks](/en/guides/webhooks/index) |
| Logs       | `logs:read` — [API logs](/en/guides/logs/index)                            |
| Workspaces | `workspace:read`, … — [Workspaces](/en/guides/workspaces/index)            |

## Common examples

| Use case            | Scopes                                              |
| ------------------- | --------------------------------------------------- |
| Transactional email | `email:send`                                        |
| CRM + sends         | `contacts:read`, `contacts:create`, `whatsapp:send` |
| Integration audit   | `logs:read`                                         |

Multiple scopes: `scope=email:send%20contacts:read`.

## Next steps

* [Quick Start](/en/oauth-api/como-funciona/quick-start)
* [Introduction](/en/oauth-api/como-funciona/introducao)
* [API keys](/en/guides/api-key/index)