Fansly API Integration: Leitfaden zu Setup, Webhooks und Endpoints

Wenn du ein Fansly-Tool baust – ein CRM, eine Automatisierung, ein Dashboard oder eine komplette Agenturplattform –, bekommst du mit der Fansly API authentifizierten Zugriff auf über 80 Live-Endpoints mit Echtzeit-Webhooks. Dieser Leitfaden zeigt dir alles, was du für eine Integration in Produktion brauchst: Kontoeinrichtung, Webhook-Verarbeitung, Credit-Budget, Teamzugriff und Monitoring im Betrieb.

Was du vor der Integration der Fansly API brauchst

Für jede Integration der Fansly API brauchst du drei Dinge:

1. Ein Fansly API-Konto – registriere dich kostenlos unter fansly-api.com/register. Der Gratis-Plan enthält 100 Willkommens-Credits, mit denen du jeden Endpoint testen kannst.
2. Einen API-Key – wird im Dashboard erzeugt, gilt pro Teammitglied und lässt sich jederzeit rotieren.
3. Ein Fansly-Creator-Konto zum Verbinden – nötig für authentifizierte Calls, die Daten auf Creator-Seite lesen oder schreiben.

Sobald du diese drei Dinge hast, kannst du deinen ersten Call absetzen.

So funktionieren Fansly-Webhooks

Webhooks sind die produktionstaugliche Alternative zum Polling. Jedes Event in Fansly – neue Nachricht, Verkauf, Verlängerung, Abo, Trinkgeld, Reaktion im Chat – löst einen Webhook an den Endpoint aus, den du im Dashboard registrierst.

Jede Webhook-Zustellung enthält:

• HMAC-SHA256-Signatur im Header X-Fansly-Signature
• Event-Typ (message.received, sale.completed, subscription.renewed, subscription.expired, tip.received, chat.reaction und weitere)
• Payload mit den vollständigen Eventdaten
• Idempotency Key zum Deduplizieren von Wiederholungen

Prüfe die Signatur, bevor du irgendetwas mit dem Payload machst:

import { createHmac } from 'crypto'
 
function verifyWebhook(body, signature, secret) {
  const expected = createHmac('sha256', secret)
    .update(body)
    .digest('hex')
  return signature === expected
}

Dedupliziere anschließend über den Idempotency Key, damit Wiederholungen keinen Schaden anrichten:

const seen = new Set()
 
function handleWebhook(event) {
  if (seen.has(event.idempotencyKey)) return
  seen.add(event.idempotencyKey)
  // Event verarbeiten
}

Webhooks kosten 1 Credit pro 100 zugestellten Events. Fehlgeschlagene Zustellungen werden mit exponentiellem Backoff wiederholt und erscheinen im Dashboard auf der Seite Webhook Logs.

Typische Webhook-Muster

• Chatbot-Sync – message.received abonnieren, KI-Inferenz ausführen, Antwort über den Messaging-Endpoint senden
• Whale-Alerts – tip.received abonnieren und einen Slack- oder Telegram-Alert auslösen, wenn der Betrag einen Schwellenwert überschreitet
• CRM-Updates – subscription.renewed und subscription.expired abonnieren und den Fan-Status mit deinem CRM synchronisieren
• Umsatz-Dashboards – sale.completed abonnieren und für Echtzeit-Reporting in dein Data Warehouse schreiben

Endpoint-Referenz der Fansly API

Die Fansly API stellt über 80 Endpoints in neun Objektkategorien bereit. Die wichtigsten Kategorien, die du zuerst integrierst:

• Konten – verbundene Konten auflisten, Tokens erneuern, Sessions verwalten
• Fans und Abonnements – Fans auflisten, Abonnenten-Kennzahlen abrufen, nach Status filtern
• Chats und Nachrichten – Nachrichten senden, Chats verwalten, stumm schalten/Stummschaltung aufheben, anpinnen/lösen, liken/Like entfernen, Galerie, Antwort-Threads
• Einnahmen und Auszahlungen – tägliche Auszahlungsplanung, Umsatzaufschlüsselungen, Tracking von Rückbuchungen (Chargebacks)
• Posts und Medien – Posts erstellen, Medien in den Vault hochladen, Medien-Scraping verwalten, optional mit URLs, die nie ablaufen
• Storys – Fansly-Storys und Story-Highlights auflisten, erstellen und analysieren
• Nutzerlisten – erstellen, aktualisieren, Nutzer für segmentierte Nachrichten hinzufügen oder entfernen
• Statistiken – Übersichtskennzahlen zu Fans, Besuchern und Posts, filterbar nach Zeitraum
• Tracking-Links – Trial- und Tracking-URLs für Kampagnen erzeugen

Die vollständige Endpoint-Referenz steht dir nach der Registrierung im Playground des Dashboards zur Verfügung.

Preise und Credits erklärt

Credits sind die Nutzungseinheit der gesamten Fansly API. Jeder Call, jeder Webhook und jeder Medien-Download verbraucht eine bekannte Zahl an Credits.

• Gratis-Plan: 100 Willkommens-Credits, um jeden Endpoint zu testen
• Basic: $69/Monat, 20.000 Credits + 1.000 RPM, 1 Konto
• Pro: $299/Monat, 100.000 Credits + 10.000 pro zusätzlichem Konto + 5.000 RPM, 5 Konten
• Enterprise: 100+ Konten mit individueller Entwicklung, Preise pro Konto ab $10

Webhook-Events kosten 1 Credit pro 100 Events. Die Credits-Tabelle auf der Seite Usage schlüsselt den Verbrauch nach Funktion auf – so weißt du immer, wohin deine Credits gehen.

Den vollständigen Vergleich der Pläne findest du auf der Preisseite.

Häufige Fragen zur Integration der Fansly API

Wie lange dauert die Integration der Fansly API? Die meisten Teams haben in weniger als einer Stunde eine funktionierende Integration in Produktion: Konto einrichten, API-Key erzeugen, erster authentifizierter Call und Konfiguration der Webhook-Abonnements.

Wie sieht die Signierung von Fansly-Webhooks aus? Jeder Webhook ist mit HMAC-SHA256 signiert. Prüfe den Signatur-Header gegen dein Shared Secret, bevor du den Payload verarbeitest. Lehne jeden Request ab, der die Prüfung nicht besteht.

Wie überwache ich Fehler der Fansly API in Produktion? Die Seite Logs im Dashboard zeigt jeden Request, jede Response und jeden Fehler in Echtzeit. Eine öffentliche Statusseite erfasst Verfügbarkeit und Störungen über alle Endpoints hinweg.

Können mehrere Entwickler am selben Fansly API-Konto arbeiten? Ja. Mit der Teamverwaltung lädst du Entwickler mit rollenbasiertem Zugriff ein. Passwörter musst du nicht teilen – jedes Teammitglied hat eigene Zugangsdaten und einen eigenen Audit-Trail.

Was passiert, wenn die Zustellung eines Fansly-Webhooks fehlschlägt? Fehlgeschlagene Zustellungen werden automatisch mit exponentiellem Backoff wiederholt. Jeder neue Versuch enthält denselben Idempotency Key, sodass dein Endpoint sicher deduplizieren kann. Die Seite Webhook Logs zeigt jeden Versuch und den endgültigen Status.

Was sich mit dem Release im Oktober 2025 geändert hat

Dieser Leitfaden berücksichtigt das große Release der Fansly API vom Oktober 2025, das Folgendes eingeführt hat:

• 100-mal günstigere Webhooks – der Preis sank von 1 Credit pro Event auf 1 Credit pro 100 Events
• KI-Chatbot in Docs und Dashboard – kontextbezogener Support, ohne deinen Workflow zu verlassen
• Tägliche Auszahlungen über den Endpoint für die Auszahlungshäufigkeit – automatische Auszahlungen an Creator
• Team-Einladungen und rollenbasierter Zugriff – Fansly API-Konten für mehrere Entwickler
• Vollständige Logs-Übersicht – jeder Request, jede Response und jeder Fehler in der Seitenleiste
• Über 22 neue Endpoints – User Lists, Subscriber Metrics, Statistics Overview, Latest Fans, Chargebacks, Chat Media Gallery, Typing Indicator, Pin/Mute/Like-Steuerung für Nachrichten, Unterstützung für Reply-To-Nachrichten und neue Filter für List Chats

Folge @onlyfansapi_updates auf Telegram, um die neuesten Updates zu bekommen.

Bereit für die Integration? Kostenlos registrieren – die ersten 100 Credits sind inklusive, keine Kreditkarte nötig.

Fragen? Schreib uns per E-Mail oder über Telegram.