Help center
Help center
Answers about test mode, keys, linking accounts and approvals. For questions about code, the docs cover every route, tool and webhook with examples.
Getting started
What do I need to get started?
An email address. Sign up, create a workspace and you can start in test mode with sandbox creators right away. You only need a creator to link their account when you are ready for live data.
What is the difference between test mode and live mode?
Test mode reads sandbox creators and never calls OnlyFans or Fansly. Live mode reads the accounts creators have linked to your workspace. Each mode has its own keys, starting bfl_test_ or bfl_live_, and the dashboard shows which mode you are in.
Where is the API reference?
At /docs/api. Every route lists its parameters and response, and the playground in the dashboard runs any route against your own workspace.
Keys and security
How do I rotate or revoke an API key?
Create a new key under Developers, move your code to it, then revoke the old one. A revoked key stops working within 30 seconds. The full key is shown once, when you create it; after that the dashboard shows only its first characters and last four.
Can a key reach only some accounts?
Yes. When you create a key you can limit it to chosen accounts and give it the read scope alone, or read and write. A key without the write scope can never ask for a write.
What are the rate limits?
Secret keys get 20 requests a second with bursts up to 60. OAuth connections, such as Claude, get 10 a second with bursts up to 30. Past the limit you get a 429 with a Retry-After header, and every response carries RateLimit headers so you can slow down before that.
How long are request logs kept?
30 days. Each call is logged with the key or client that made it, the account, the route, the status and how long it took, including the time spent waiting on OnlyFans or Fansly.
Accounts and linking
Is BetterFans Link affiliated with OnlyFans or Fansly?
No. BetterFans Link is independent and is not affiliated with, sponsored by or endorsed by OnlyFans, Fenix International Limited or Fansly. You are responsible for using it within each platform's terms and with the consent of each creator.
Which accounts can I link?
OnlyFans and Fansly accounts whose creators agree to it. Linking takes the account's own sign-in details and any code the platform asks for, so an account can only be linked by someone who can sign in to it. Creators can link their own accounts on a page we host.
What happens to the password a creator types?
It is used to sign in to OnlyFans or Fansly and is encrypted before it is stored. The dashboard and the API never show it.
What does an account status like Needs relink mean?
The platform signed the session out, so live calls on that account return account_unavailable until the creator links it again. Synced data stays readable and shows when it last synced. Awaiting 2FA and Awaiting selfie mean the platform asked for a check, and Restricted means OnlyFans limited the account.
What happens when I remove an account?
Your workspace loses access to it. The creator stays signed in, and any other workspace they linked keeps its access.
Fansly accounts
Where does a Fansly creator get the sign-in code?
Fansly sends it by email or the creator reads it from their authenticator app, depending on how their account is set up. The hosted link page says when Fansly emailed it. Fansly never asks for a selfie or a human check during linking.
Which statuses can a Fansly account have?
Five: Healthy, Syncing, Awaiting 2FA, Needs relink and Disconnected. A Fansly account is never Awaiting selfie or Restricted, because Fansly has neither. A new account shows Syncing until its first full sync, for up to 30 minutes after the creator signs in.
Why are Fansly ids so long?
Fansly user ids are too large for a JavaScript number to hold exactly, so every id in the API is a string. Keep account, fan and media ids as strings end to end, and never parse them into numbers, or two different fans can end up with the same id.
Does Call Fansly work with a test key?
No. Test keys never reach Fansly, so Call Fansly answers resource_not_found with one. In test mode, use the dedicated routes against Sloane, the Fansly sandbox creator. Call Fansly needs a live key and a linked Fansly account.
Writes and approvals
Who can approve a write?
Owners and admins of the workspace. Developers can approve test writes, which are simulated, but not live ones. Workspace viewers can see pending actions but cannot decide them.
What happens if nobody approves a pending action?
It expires after 24 hours and nothing is sent. GET /v1/actions/{actionId} and the get_action tool report it as expired.
Why did my request fail with writes_disabled?
Writes are off for each account until an owner or admin turns them on in that account's settings. Reads work either way.
Support
How do I get help?
Email hello@betterfans.link with your workspace name, what you expected and what happened. If a call failed, include the request id from the error body or the x-request-id header so we can find that exact call.
I found a security problem. Where do I report it?
Email hello@betterfans.link with the details and the steps to reproduce it. Please test only against accounts and workspaces you own.
GET STARTED
Still stuck?
Email us with your workspace name, what you expected and what happened. Include the request id from the error or the request log.
Questions first? Write to hello@betterfans.link.