Managed endpoints are currently in beta. We may adjust request or response shapes, add or rename fields, or refine endpoint behavior as we gather feedback from users. If you need a lower-level escape hatch for unsupported or fast-moving upstream paths, use the proxy endpoints.
Access Guide
Complete guide with authentication, endpoints, media proxy, rate limiting, and troubleshooting
Quick Reference
| Type | Base URL | Use Case |
|---|---|---|
| Managed | /v2/access/* | Typed routes for users, posts, messages, vault |
| Proxy | /v2/access/proxy/* | Any OnlyFans API path |
Authentication
All Access API requests require a connection and an API key with theACCESS scope.
Proxy Endpoints
Passthrough to any OnlyFans path
Connections
Create, import, and manage connections
Permission Reference
| Permission | Grants Access To |
|---|---|
all:read | Read access to the entire account |
all:write | Write access to the entire account |
profile:read | Read profile information |
profile:write | Update profile information |
notifications:read | Read notifications |
posts:read | Read feed posts |
posts:write | Create and manage feed posts |
vault:read | Read vault media and lists |
vault:write | Manage vault media and lists |
messages:read | Read messages and chats |
messages:write | Send and manage messages |
subscribers:read | View subscribers |
subscribers:write | Manage subscribers, including notes, names, and discounts |
subscriptions:read | View subscriptions and following |
subscriptions:write | Manage subscriptions, including follow, unfollow, and mute actions |
users:write | Block or restrict users, and view blocked or restricted lists |
lists:read | View user lists |
lists:write | Manage user lists |
promotions:read | View promotions |
promotions:write | Manage promotions |
earnings:read | View earnings and transactions |
analytics:read | View analytics and statistics |
payouts:write | Initiate withdrawals |