Webhooks in Tolt
Webhooks let Tolt automatically notify your app when something happens, like when a partner signs up, a transaction is created, or a commission is generated. Instead of checking for updates manually, Tolt sends the data directly to your webhook endpoint as soon as the event occurs.
This makes webhooks a simple way to keep your system in sync. However, webhooks work asynchronously. Delivery is usually fast, but not guaranteed to be immediate or successful every time. Because of this, webhooks should not be used for steps where your app needs an instant confirmation (like onboarding flows). They’re designed for automating follow-up actions, not blocking user-facing processes.
How Tolt Webhooks work
When an event happens in your Tolt account, we send an HTTP POST request to the webhook URL you’ve set up. The request includes structured JSON with details about the event, so you can trigger actions like:
Syncing data to your database
Sending emails or notifications
Connecting to third-party tools
Tolt uses Svix to handle webhook delivery, retries, and message management.
Supported event types
To view all available webhook events:
Go to Settings → Webhooks in your Tolt dashboard.
Open the Event Catalog tab.
Webhook payload format
Each webhook message contains:
Field | Description |
| The event data (for example, the partner or transaction object). |
| The event type (e.g. |
| The time when the event occurred (in ISO 8601 format). Example: |
Example for partner.created:
{ "data": { "id": "part_123", "first_name": "Jane", "last_name": "Doe", "email": "[email protected]", ... }, "timestamp": "2025-04-23T13:00:51.351Z", "type": "partner.created" }Handling delivery and failures
Automatic retries
If your webhook endpoint doesn’t respond, Svix will retry sending the message automatically based on their retry schedule. Retries stop if you remove or disable the endpoint.
See the Svix Retry Schedule for more details.
Replay past events
Missed a webhook due to downtime or a misconfiguration? You can replay messages directly from your Tolt dashboard:
Open Settings → Webhooks.
Select the relevant endpoint.
Under Message Attempts, choose the message you want to resend.
Select:
Replay this message only
Replay all failed messages since the first failure
Replay all missing messages in that time range
Keep your Webhooks secure
To make sure your webhook listener only accepts valid requests:
Verify the signature: Every webhook message is signed by Svix. Always verify the signature to confirm the request is authentic. See the Svix webhook verification guide or how to verify manually.
Limit by IP (optional): You can also restrict access to your endpoint by allowing only Svix’s IP ranges.