Webhooks

Webhooks allow you to receive real-time HTTP notifications when certain events happen in your Fansly API integration. They're useful for keeping your local database in sync or triggering actions when events occur asynchronously.

Overview

Instead of constantly polling the API to check for updates, you can register a webhook URL. When an interesting event occurs (like a new message received, a new subscription, a new tip, etc.), Fansly API will send an HTTP POST request containing a JSON payload with the event details.

Setting Up Webhooks

To receive webhooks, you need to:

1. Create an Endpoint: Set up a server endpoint that accepts POST requests.
2. Configure your Endpoint URL: Register your webhook URL in your Fansly API dashboard.
3. Handle Events: Process the incoming webhook payload.
4. Respond: Return a 200 OK or 204 No Content status code quickly to acknowledge receipt.

Securing Webhooks

When setting up webhooks, ensure you're validating that the incoming request actually comes from the Fansly API. Use secret keys to verify signatures. Detailed signature verification steps will be added here.