> ## Documentation Index
> Fetch the complete documentation index at: https://www.dropfans.io/developers/llms.txt
> Use this file to discover all available pages before exploring further.

# API categories

> Each app has a switch per API category. Most are on; Payouts and Onboarding start off until we enable them for your app.

- Source: https://www.dropfans.io/developers/concepts/api-categories
- Section: Concepts
- OpenAPI: https://www.dropfans.io/developers/openapi.json

Every endpoint belongs to exactly one **API category**, named on its reference page. Each approved app has a switch per category. A call to a category that is off for your app returns:

```json
{ "error": "This app does not have the payouts API category enabled. Contact support to enable it.", "code": "api_category_disabled", "category": "payouts" }
```

with status `403`. The switches apply to every key bound to the app — keys themselves are not scoped — and to Dropfans-operated apps too.

| Category | `category` | Default | Covers |
| --- | --- | --- | --- |
| Account | `account` | always on | GET /me, profile, timezone, subscription tier. Always on. |
| Creator onboarding | `onboarding` | **off** | Creator sign-up from your page: POST/GET /accounts, KYC sessions. |
| Agency roster | `agency` | on | The agency endpoints: roster, personas, invites, roster revenue. |
| Vault | `vault` | on | Vault items, folders, tags, video uploads. |
| Drops & checkout links | `drops` | on | Drops, previews, check-status, orders. |
| For You posts | `posts` | on | For You posts. |
| Links | `links` | on | Profile, tip, subscribe and buy links. |
| Earnings & balance | `earnings` | on | Earnings, the earnings ledger, tips, GET /balance. |
| Payouts | `payouts` | **off** | Payout summary and history, payout methods, the MassPay wallet, payout requests. |
| Revenue splits | `splits` | on | Revenue splits between partners. |
| Telegram notifications | `notifications` | on | Telegram sale notifications. |
| App webhooks | `webhooks` | on | Your app’s webhook endpoint: set, rotate, test. |
| CRM dashboard | `crm` | on | Your integration dashboard: GET /crm/app, stats, transactions, accounts. |

## Getting a category switched on

Write to support from the app owner’s account and say which category you need and why. Payouts can move a creator’s money, so we review that one most closely. [GET /crm/app](https://www.dropfans.io/developers/reference/get-crm-app.md) and [GET /me](https://www.dropfans.io/developers/reference/get-me.md) list your app’s categories with `enabled` for each, so you can hide features that are off.

## Personal keys

A personal key (not bound to an app) has no switches: it can call every category for its own account, with two exceptions. App-level endpoints (onboarding, webhooks, the CRM dashboard) need your app owner’s key. Payout **writes** — payout requests, payout methods and the MassPay wallet setup — need an app key with Payouts on (403 `app_key_required`). Reading payouts works with a personal key.

Next: [Apps & approval](https://www.dropfans.io/developers/concepts/apps-and-approval.md) or [Errors](https://www.dropfans.io/developers/concepts/errors.md).

---

Previous: [Apps & approval](https://www.dropfans.io/developers/concepts/apps-and-approval.md) · Next: [Rate limits](https://www.dropfans.io/developers/concepts/rate-limits.md) · All pages: [llms.txt](https://www.dropfans.io/developers/llms.txt)
