Webhooks

Webhooks allow you to receive real-time HTTP push notifications when specific events occur within your Fansly API integration. They are ideal for synchronizing local databases or triggering automated workflows asynchronously.

Overview

Rather than continuously polling the API for updates, you can register a secure webhook URL. When a subscribed event occurs (e.g., a new message, subscription, or tip), the Fansly API will send an HTTP POST request to your endpoint containing a JSON payload with the event details.

Setting Up Webhooks

To start receiving webhooks, follow these steps:

1. Create an Endpoint: Set up a server endpoint configured to accept POST requests.
2. Configure Your Webhook: Register your endpoint URL and select your desired events in the Developer Console.
3. Handle Events: Parse and process the incoming JSON webhook payload.
4. Acknowledge Receipt: Promptly return a 200 OK or 204 No Content status code to confirm receipt of the event.

Securing Webhooks

To ensure the integrity and authenticity of inbound requests, you must validate that they originate from the Fansly API. This is accomplished by verifying cryptographic signatures using your webhook signature secret. Detailed signature verification instructions will be provided here.