Skip to main content

Syncing Data

Welcome to the guide on syncing data for the Fansly Creator bot! This guide will walk you through the steps to sync your Fansly data with the bot. Syncing data is an important step in the setup process, as it allows the bot to assign roles to users based on their Fansly subscription level.

Why do I need to sync data?​

Unfortunately, we are unable to automatically sync your data from Fansly. This is due to the way Fansly has their API set up. This is mostly for security reasons, and we understand that. We don't want to violate any terms of service, so we have to ask you to setup the sync process manually.

We understand that this is an inconvenience, but we hope that you understand the reasoning behind it. We are always looking for ways to improve the bot and make it easier for you to use.

How does syncing work? Is it safe?​

Syncing data is done using your fansly account token. This token is used to authenticate with the Fansly API and retrieve your data. All syncing processes are done locally, on your computer using a application we developed. This application is open source and can be found on our GitHub for anyone to review or audit.

We take security very seriously and have taken steps to ensure that your data is safe and secure. We do not store any of your data on our servers, and all sensitive data is stored locally on your computer. The tool we provide generates a JSON file that is used to sync your data with the bot. No private information is stored in this file, only the necessary data to sync with the bot. You can open the file and review it before syncing to ensure that no private information is being stored.

What exactly is a token?​

Tokens, or commonly referred to as Authentication Tokens/API Tokens, are a way to authenticate with a service without providing your username and password. This is a more secure way to authenticate with a service, as it allows you to revoke access at any time without changing your password.

What access does the token have?​

Technically, the token has access to everything on your account. However, we only use the token to retrieve the following information:

  • Your account information (username, email, etc.)
  • Your followers (user IDs only)
  • Your Subscribers (a full subscription object. This can include the user's username, id, tier id, and other information)

What exactly is stored in the JSON file and what stays on the server?​

The JSON file contains the following information:

  • Your followers, in an array of user IDs
  • Your subscribers, in an array of subscription objects

The entire sync file is stored on our servers, but not your token. The token is only used to generate the file, and is not stored on our servers. The file is saved to allow any users who missed a sync wave to still get their roles.

I still have concerns about security. What can I do?​

We understand that most people using our products do not have a technical background, and may not understand the security implications of using a token. Please, if you have any concerns, reach out to us on our discord server and we will be happy to help you understand the process better.

I don't want to use the sync tool or provide my token. Can I still use the bot?​

Unfortunately, no. The sync tool is required to sync your data with the bot. This is the only way we can ensure that your data is up to date and accurate. We understand that this may be disappointing, but we hope that you understand the reasoning behind it.

For this reason, we offer refunds for any users who are not comfortable with the sync process. Please reach out to us on our discord server to request a refund.

How to sync your data​

First, 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.

Setting up the tool for the first time​

When you first run the tool, you'll be prompted to enter your Fansly account token. You can find your token by following the steps below.

Getting your Fansly account token​

  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

note

This may look different depending on your browser. The steps are the same, but the layout may be different.

  1. Press the "Network" tab at the top of the window.

Network Tab

note

You may have to click the arrow to expand the tab if it is not visible. This is usually located on the left side of the window.

  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​

Now that you have set up the tool, you can sync your data with the bot. To do this, follow the steps below.

  1. Click the "Sync Now" button in the tool.

Sync Button

  1. The tool will begin syncing your data. This may take a few minutes, depending on the number of followers and subscribers you have. Once complete, you will see a success message in the tool. Additionally, you will see a system notification that the sync is complete. Feel free to minimize the tool while it is syncing.

Sync Complete

  1. Click "Copy" and then "Close" on the dialog. Close FanslySync.

  2. Open Discord and run /sync <url> in the bot channel. This will sync your data with the bot and assign roles to your users based on their Fansly subscription level.

Sync Command

Confirm the sync by clicking the "Confirm" button in the dialog.

Sync Confirm

  1. The bot will begin syncing your data. This may can take a while depending on the number of followers and subscribers you have. Once complete, you will see a success message in the bot channel.

Sync Complete

Frequently Asked Questions​

I'm having trouble setting up the tool, or it's saying my token is invalid. What should I do?​

Ensure your token is correct and that you have copied the entire token. If you are still having trouble, please reach out to us on our discord server for assistance.

I accidentally closed the tool before copying the URL. What should I do?​

No worries! You can run the tool again and click "Copy" to copy the URL. You can then paste the URL into the bot channel to sync your data.

I'm getting an error when syncing my data. What should I do?​

If you are getting an error when syncing your data, please reach out to us on our discord server for assistance. We'll be happy to help you troubleshoot the issue.

How do I update the tool?​

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

The tool will restart after updating.

How do my users get their roles?​

They must /link with the bot to get their roles. This is a security measure to ensure that only users who have access to your Discord server can get their roles. The bot will automatically assign roles when a sync is executed by you. Linking is done by having a standard fansly account and being able to change the about section.

If they aren't linked, they won't get their roles.

I have another question that isn't answered here. What should I do?​

Please reach out to us on our discord server and we'll be happy to help you with any questions or concerns you may have.

Conclusion​

You have now successfully synced your Fansly data with the bot! If you have any questions or need further assistance, please don't hesitate to ask in our discord server. We're here to help!

Happy creating! 🎉