Welcome to the new Fansly Creator Bot documentation! We have made some changes to the layout and structure of the documentation. If you have any feedback or suggestions, please let us know in our Discord server!
Fansly Creator Bot logo
Fansly Creator BotDocumentation

Syncing Data

Learn how to sync your Fansly data with the bot.

Syncing Your Fansly Data

This is one of the core aspects of the Fansly Creator bot. It allows you to keep your Fansly data up-to-date with the bot, ensuring that your subscribers receive the correct roles and permissions based on their subscription status.

Unfortunately, the Fansly API imposes some limitations on us, which we have to work around. Here's some common questions and answers about syncing data:

How to sync your Fansly data (Management Session Tokens)

This is the recommended way to sync your Fansly data. Management Session Tokens provide a more secure and privacy-focused method for syncing your data without exposing your full account token.

Getting your Management Session Token

  1. Log in to your Fansly account.
  2. Go to the Management Sessions page.
  3. Click "Create Session"
  4. Uncheck all permissions. We currently do not need any special grants besides the token itself.
  5. Click "Create" and copy the generated URL.
  6. Grab the token from the URL. It will look something like this:
https://fansly.com/managementsession/claim/ODEwNTkwNTQwNDU3MzQwOTI4OjE6MTpkN2MyNzQ5Yxxxxxxxxxxxxxxxxx

Where everything after the last slash is your token, in this case ODEwNTkwNTQwNDU3MzQwOTI4OjE6MTpkN2MyNzQ5Yxxxxxxxxxxxxxxxxx

Important

Do not share this URL with anyone (or token) as they can claim at and gain (limited) access to your Fansly account.

If you suspect that your token has been compromised, please go back to the Management Sessions page and revoke the token. You can always set another in the bot by following this guide again.

Setting up the Management Session Token in the Bot

  1. Open your Discord server where the Fansly Creator Bot is installed.
  2. Run the /sync setmanagementtoken <token> command and paste the token you copied earlier into the prompt.
  3. The bot will validate the token and store it securely for syncing your data.

Note

The Management Session Token is stored securely on our servers, encrypted with AES-256-GCM. Additionally, the secret used to encrypt these tokens is stored securely within Infisical, a secrets management tool.

In the rare event that we suffer a security breach, we will roll the encryption keys and invalidate all existing tokens. You also may revoke the token at any time from the Management Sessions page.

Success! 🎉

Your Management Session Token has been successfully set up in the bot. We will automatically sync your Fansly data using this token every hour. Sync data is also saved for users who missed a sync wave. They can use the /checkroles command to retrieve their roles and apply them immediately.

How to Sync Your Fansly Data (Sync Tool)

Deprecation Notice

This method of syncing your Fansly data is being deprecated in favor of the Management Session Tokens approach. We recommend using the new method for improved security and privacy.

All related tooling, endpoints, commands, and documentation will be removed in approximately 1 month from this update being published. The Management Session Tokens approach will be the only supported method for syncing your Fansly data.

With that out of the way, let's get into how to sync your Fansly data with the bot.

Download the Sync Tool

You'll need to download the sync tool from our distribution partner, CrabNebula. You can download the latest installer here. We recommend downloading the nsis installer for Windows, and the dmg installer for MacOS. Linux users can download the AppImage installer.

Once you have downloaded the installer, run it and follow the on-screen instructions to install the tool.

Getting your Fansly Token

To sync your data, you will need to provide your Fansly token. This is a one-time process, and we'll guide you through it.

  1. Log in to your Fansly account. Preferably in a private browsing window. This is to ensure that the token is not invalidated when you log out.
  2. Press control + shift + i to open the developer console or right-click on the page and select "Inspect". A window will open on the right side of the page.

Inspect Element

Browser differences

The steps to open the developer console may vary slightly depending on your browser. The above steps are for Google Chrome, but similar steps can be followed in Firefox and other browsers.

  1. Click on the "Network" tab in the developer console. Network Tab

Show Network Tab

You may have to click an arrow to show the network tab if it is not visible. This is usually located at the top of the developer console.

  1. Refresh the page by pressing F5 or clicking the refresh button in your browser.

  2. In the "Filter" box, type account and press enter. This will filter the requests to show only the ones that contain the word "account". Find the one that begins with /api/v1/account/me and click on it.

  3. In the "Request Headers" tab, find the "authorization" header. This is your Fansly account token. It will have a bunch of random characters and look something like this:

NjcyNTYyNjIzODA3NDk2MTkyOjE6Mjo0ZTAzMWU3YmIwOWQ4YjhiZDVmY2VhOTUddddfgwko

See the image below for an example: Filter Requests

DO NOT EVER SHARE THIS TOKEN WITH ANYONE ELSE. THIS TOKEN GIVES FULL ACCESS TO YOUR ACCOUNT AND SHOULD BE KEPT PRIVATE.

As we mentioned before, we do not store this token on our servers. It is only used to generate the sync file and is not stored anywhere else. If anyone asks for this token, they are trying to scam you. Please do not share it with anyone.

You can invalidate this token at any time by changing your password on Fansly or logging out of all sessions. (This will invalidate all tokens, so you will have to generate a new one.)

Setting up the sync tool

  1. Copy the token from the "authorization" header in the developer console. Make sure you copy the entire token, no spaces, no extra characters. This will fail if you do not copy the entire token.

  2. Open FanslySync. You are greeted with a setup wizard

Setup Wizard

  1. Paste your token into the "Token" field and click "Next".

Paste Token

  1. Your token is validated and you can now click "Next" to proceed.

Token Validated

Syncing Your Data

There are two ways to sync your data with the bot: manually and automatically. We recommend using the automatic sync, as it will keep your data up-to-date without any manual intervention. Your PC will need to be on and the FanslySync tool running in the background for this to work. FanslySync can run in the background without any issues, so you can continue to use your computer as normal.

Note

We highly recommend using the automatic sync feature, as it will keep your data up-to-date without any manual intervention. You can run manual syncs if you prefer, but this will require you to run the FanslySync tool every time you want to sync your data.

Setting up Automatic Sync

Get a sync key

To set up automatic syncing, you will need to get a sync key from the bot. This key is used to authenticate with the bot and allow it to sync your data. You can get a sync key by running the /sync auto command in Discord. This will generate a sync key that you can use in the FanslySync tool.

Sync Key

Don't share your sync key!

The sync key is used to authenticate with the bot and should be kept private. Do not share it with anyone, as it will allow them to sync their data with your server, which could lead to people getting or being removed from your server without your consent. Support will never ask you for your sync key. If anyone asks for your sync key, they are trying to scam you. Please do not share it with anyone.

Sync Key

This key is only shown once, so make sure to copy it and save it somewhere safe. If you lose this key, you will need to generate a new one by running the /sync auto command again. This will invalidate the old key.

Configure automatic sync in FanslySync

Open FanslySync and click on the "Sync" tab. Paste the sync key into the "Sync Key" field and click "Next".

Paste Sync Key

The tool will now connect to the bot and validate the sync key. If the key is valid, a green checkmark will appear next to the key. If the key is invalid, a red cross will appear. Please make sure to copy the key correctly, as it is case-sensitive and must match exactly.

Next, you will need to select the sync interval. This is how often the tool will sync your data with the bot. The default is 1 hour.

Sync Interval

We recommend setting the sync interval to 6 hours, as this will keep your data up-to-date without putting too much strain on the Fansly API. You can set it to a lower value if you want, but this may result in more API calls and could lead to rate limiting. We are not responsible for any rate limiting issues that may arise from setting the sync interval too low.

Start the automatic sync

Once you have configured the sync key and interval, click "Save". An sync will run immediately to fetch your data from Fansly and sync it with the bot. You can monitor the progress using the progress bar at the bottom of the window.

Sync Progress

A notification will appear when the sync is complete, and you can now close the FanslySync tool. The tool will continue to run in the background and will automatically sync your data at the interval you specified.

Manual Syncing

If you prefer to manually sync your data, you can do so by clicking the "Sync Now" button in the FanslySync tool. After this is complete, a small bar will appear at the bottom of the window with a "Copy" button. Click this button to copy the sync data URL to your clipboard.

After copying the URL, you can input it into the bot to sync your data (using the /sync <url> command). An image is shown below to illustrate this process:

Manual Sync

After running the command, it will take a few seconds to grab the data. After, it will ask for confirmation to sync the data. If you are sure that the data is correct, Click the "Confirm" button to sync the data with the bot. All users will be given the correct roles and permissions based on their subscription status. After this, you will receive a confirmation message that the sync was successful.

Confirm Sync

Sync Success

Troubleshooting/FAQ

A couple of common issues that may arise during the sync process:

My Sync Token/Fansly Token isn't working! What do I do?

  1. Double-check that you have copied the token correctly. Tokens are case-sensitive and must be copied exactly as they appear.
  2. Make sure that the token has not expired. If you generated a new token, you will need to use the new one.
  3. If you are still having issues, try regenerating the token by running the /sync auto command again. (only for the sync token)

I closed the tool before copying the sync URL or I lost the sync URL. What do I do?

Simply run the sync again by clicking the "Sync Now" button in the FanslySync tool. This will generate a new sync URL that you can use to sync your data with the bot.

I am getting an error when trying to sync my data. What do I do?

If you are getting an error when trying to sync your data, please reach out to us on our discord server with the error message and we will be happy to help you troubleshoot the issue.

How do I update the tool?

A dialog will appear when a new version of the tool is available. You can click the "Update" button to download and install the latest version.

How do my users get their roles?

They must be linked with the bot. A guide on how to do this can be found in the Linking Your Fansly Account section of the documentation. Once they are linked, the bot will automatically assign them the correct roles based on their subscription status.

If they have recently linked but a sync hasn't been run yet, they can use /checkroles to update their roles immediately. This will check their subscription status and assign the correct roles based on the latest sync data.