Webhooks Overview

SettleSettle webhooks let your servers receive real-time, event-driven HTTP POST notifications when key user behavior and lifecycle signals occur inside your workspace.

By subscribing to webhooks, you don't have to repeatedly poll our APIs to stay up-to-date with event pricing, customer wallets, or critical intelligence telemetry.

Registering Your Endpoint#

To configure a webhook:

1. Go to your SettleSettle Dashboard and open Application Settings.
2. Scroll to the Developer Webhooks panel.
3. Enter your public HTTPS URL (e.g. https://api.yourdomain.com/webhooks/settlesettle).
4. Click Register Webhook.
5. Copy the secure signing key (wh_sec_...) immediately. For maximum security, this secret key is displayed only once during registration.

Testing Webhooks#

You can trigger a manual mock event directly from the dashboard:

• Under your configured webhooks list, click the Test button next to your endpoint.
• SettleSettle instantly dispatches a test payload containing a mock version of your subscribed events, allowing you to debug and verify your server-side handler before deploying live.