Skip to content

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, Fansly or Fanvue. 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, Fansly or Fanvue.

Accounts and linking

No. BetterFans Link is independent and is not affiliated with, sponsored by or endorsed by OnlyFans, Fenix International Limited, Fansly or Fanvue. You are responsible for using it within each platform's terms and with the consent of each creator.

OnlyFans, Fansly and Fanvue 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, and a Fanvue account connects through Fanvue's own sign-in.

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. A Fanvue password is typed on Fanvue's own page and stays with Fanvue.

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. A Fanvue account has no synced copy, so none of its data can be read until the creator links it again.

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 finishes. A creator Fansly has signed out shows Needs relink.

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.

Fanvue accounts (Beta)

How does a Fanvue creator connect?

The creator opens the link, presses Continue to Fanvue and signs in on Fanvue's own page, then allows BetterFans. Fanvue sends them back to the link, which says when they are connected. Only the creator's own Fanvue login works: a team member login ends with not_creator_account.

Which statuses can a Fanvue account have?

Three: Healthy, Needs relink and Disconnected. A Fanvue account has no sync, so it is never Syncing, and Fanvue asks for any code on its own page, so it is never Awaiting 2FA, Awaiting selfie or Restricted. A creator who removes BetterFans on Fanvue shows Needs relink.

Why does every Fanvue read count as a live call?

BetterFans Link keeps no copy of a Fanvue account, so every read asks Fanvue at that moment. Each one counts as a live call on your plan, and meta.source says live. Read a Fanvue account as often as your work needs, and keep what you need on your side.

Does Call Fanvue work with a test key?

No. Test keys never reach Fanvue, so Call Fanvue answers resource_not_found with one. In test mode, use the dedicated routes against Marlo, the Fanvue sandbox creator. Call Fanvue needs a live key and a linked Fanvue 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.