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

# OAuth Scopes

> Complete list of OAuth 2.0 scopes available in the HoopAI Platform API

# OAuth 2.0 Scopes

This document provides a comprehensive listing of OAuth 2.0 scopes required to access API endpoints and webhook events.

## Key Information

The scope table organizes access permissions across multiple feature areas including:

* **Business Management**: businesses (read/write)
* **Calendar Operations**: calendars, groups, resources, and events (read/write)
* **Contact Management**: contacts with tasks, notes, and campaign associations
* **Conversations**: messaging, recordings, and transcriptions
* **Financial**: invoices, payments, subscriptions, and transactions
* **Marketing**: campaigns, forms, workflows, and social media posting
* **Content**: blogs, courses, emails, and surveys
* **Administrative**: users, locations, and custom fields/values

## Access Types

The scopes are designated for two primary access levels:

* **Account**: Standard operational access for account users
* **Admin**: Administrative access for platform-level management

The scopes specify which endpoints require `read` (readonly) versus `write` permissions, and list associated webhook events where applicable. Each scope grants access to specific HTTP methods (`GET`, `POST`, `PUT`, `DELETE`, `PATCH`) on designated endpoints.

## Scope Format

Scopes follow the format:

```
resource/action.permission
```

For example:

```
conversations/message.readonly
conversations/message.write
```

When building your authorization URL, separate multiple scopes with spaces:

```
scope=conversations/message.readonly contacts.readonly calendars.write
```