Docs Menu

Documentation

Everything you need to get started with the Creator Platform and the self-hosted bot.

Getting Started: Your First-Time Setup

Welcome, creator! This guide will walk you through the essential first steps to verify your creator account, connect your Fansly profile, and get your Discord bot up and running.

To keep your subscriber roles updated on Discord, NotiFansly needs to sync your Fansly subscription data. We offer two ways to connect: Server-Side Sync (Recommended) and the Desktop Sync App.

Step 1: Connect Your Fansly Account

Go to the Dashboard Settings Page under the Creator Verification & Syncing section. You can choose either method:

Option A: Server-Side Sync (Recommended - Beta)

Server-Side Sync uses Fansly’s official Management Sessions feature. It automatically syncs your subscriber and follower data periodically in the background—meaning you don’t need to keep a desktop app running on your computer.

🛡️ Safe & Restricted by Design

Fansly Management Session tokens allow controlled access to account data. NotiFansly does not require any permissions or grants. When creating your session, uncheck all permission boxes. The token will only be used to read your follower and subscriber lists.

  1. Generate a Management Session on Fansly:
    • Log in to your Fansly account and open your Creator Dashboard.
    • Navigate to the Management Sessions page and click Create Session.
    • Give it a name (e.g., NotiFansly Sync).
    • Uncheck all permission boxes (no special grants are needed for role syncing).
    • Click Create and copy the generated link or token. It will look like this: https://fansly.com/managementsession/claim/ODEwNTkwNT...
  2. Verify on NotiFansly:
    • On your Account Settings page, select the Server-Side Sync tab.
    • Paste your Management Session link or token into the input field and click Verify & Enable Server Sync.

Your account is now connected! NotiFansly will automatically sync your subscriber tiers and active fans in the background.

Option B: Desktop Sync App (Alternative / Local)

If you prefer to run the sync process locally on your own computer without sharing a session token, you can use our open-source Desktop Sync App.

  1. Download the App:
  2. Get Your Sync Key:
    • Open the NotiFansly Sync app on your computer.
    • Paste in your Fansly Authorization Token (see the easy browser method below).
    • Click Connect & Verify. The app will confirm your profile and generate a unique Sync Key.
  3. Link Your Account on the Dashboard:
    • Copy your Sync Key from the desktop app.
    • Paste it into the Sync Key field on the Account Settings page and click Verify Sync Key.

A Note on Security & Trust

The NotiFansly Desktop App is fully open-source. Your auth token is used strictly on your machine to communicate directly with Fansly's API and is never transmitted to our servers.

How to get your Fansly Auth Token for the Desktop App (Click to expand)
  1. Go to fansly.com, log in, and open Developer Tools (F12 or Ctrl+Shift+I).
  2. Click on the Console tab.
  3. Paste the following code snippet and press Enter:
console.clear();
const activeSession = localStorage.getItem("session_active_session");
const { token } = JSON.parse(activeSession);
console.log('%c➡️ Authorization_Token:', 'font-size: 14px; color: #8B5CF6; font-weight: bold;', token);

The console will output your Authorization_Token. Copy the long string of characters and paste it into the desktop app.

⚠️ Warning: Your Authorization Token provides full access to your account. Never share it with anyone.

Step 2: Configure Your Server Settings

Once verified, you can customize how NotiFansly works in any Discord server where you have management permissions.

  1. Go to the Dashboard: Navigate to Dashboard.

  2. Select a Server: Click on the server you want to manage.

  3. Select Your Creator Profile: On the left sidebar, select your username under monitored creators.

    Note: If your profile isn’t listed yet, ask a server admin to add your Fansly username using the /add command or the “Add Creator” button on the dashboard.

Step 3: Configure Notifications & Role Linking

Once your profile is selected, you can configure notification channels and fan roles:

  • Post & Livestream Notifications: Enable toggles, select announcement channels, and choose optional mention roles (e.g., @Notifications). You can also set custom embed colors and custom announcement messages.
  • Custom Live Image: Upload a custom “Coming Soon” or “I’m Live!” image that will be included in your livestream alert embeds.

🛠️ Notification Troubleshooting

If notifications aren't posting, ensure the NotiFansly Bot has the following permissions in your chosen Discord channel:

  • View Channel: Required for the bot to see the channel.
  • Send Messages & Embed Links: Required to post rich embeds.
  • Mention @everyone, @here, and All Roles: Required if pinging a notification role.

Fan Role Linking (Creator Feature)

As a verified creator, you will see the “Fan Role Linking” card:

  • Follower Role: Select the Discord role granted to users who follow your Fansly account.
  • Subscriber Role: Select the general role given to fans subscribed to any of your tiers.
  • Tier-Based Roles: Map specific Discord roles to individual Fansly subscription tiers. Ensure your Fansly data has synced so your active tiers appear in the dropdowns.

⚠️ Important: Discord Role Hierarchy

Discord bots can only assign roles that are below their own highest role in the server settings:

  1. Open your Server Settings in Discord.
  2. Go to the Roles tab.
  3. Drag the NotiFansly role so it sits above all subscriber/follower roles.

Click Save Changes when finished.

Your automated role system is active! Now inform your community:

  • Announce that fans can run the /link <fansly-username> command in your Discord server.
  • The bot will walk them through a quick 1-step verification process to confirm ownership of their Fansly account and assign their Discord roles.
  • Share our Fan Linking Guide with your community for step-by-step instructions.

That’s it! Your community role sync system is now fully operational.

Previous

Introduction

Next

Fan Linking Guide