Interested in using Webhooks?
Webhooks in Spotler SendPro are an add-on. To explore the possibilities, please contact your account manager.
Webhooks in Spotler SendPro allow you to receive real-time updates about specific message events in your own system. This is ideal if you are already using Event Flows in SendPro, want to link multiple systems and products together or if you have build your own front end on top of our API. Event Flows and Webhooks work differently, so you can pick which method works best for you.
In this article you will learn more about:
Webhooks overview
The Webhooks page displays a list of all configured webhooks, including their Description, Webhook URL, and Status. From this overview, you can create a new webhook or manage existing ones through the three-dot menu (Edit, Enable/Disable webhook, delete).
Create or edit a Webhook
When you click in Create Webhook, you start setting up a new webhook. Editing a webhook will send you to the same page, this page is already filled in with data from the already set up webhook. Here you will find the following fields:
General settings
- Description: Name of the webhook
- Webhook URL: Endpoint that receives events
- Add message tags from the original message: Include original message tags, if available
Filters (optional)
- Filter sources: Filter from selected sources (default: all sources included)
- Filter event types: Filter on types of events (default: all events included)
Webhook filters
When creating a new webhook, all available sources and event types are enabled by default. Although the filter fields appear empty, this does not mean that nothing is selected. If you leave the filter unchanged, the webhook will deliver all events from all sources.
To limit the scope of the webhook, you can manually select specific sources and/or event types:
- Open the webhook configuration screen.
- In the Sources section, select the sources you want to include.
- In the Event types section, select the event types you want to include.
Once selected, only the chosen sources and event types will be delivered to the webhook.
Headers
You can add custom headers (Header name + Header value) to support Header Authentication or to easily recognise the webhook.
Advanced settings
- API version: Defaults to latest available version
- Max batch size: Maximum number of events per call
- Max concurrency: Number of parallel connections allowed
Limits
Max concurrency and Max batch size define how fast and how many events are sent. These are advanced parameters typically set by Spotler during setup or support. If needed, contact Spotler Support to discuss adjusting these limits.
Webhook status
- Toggle to enable or disable the webhook
Webhook details page
This page provides a read-only summary of the webhook settings, including:
- Description
- Webhook URL
- API Version
- Enabled (yes/no)
- Add message tags (yes/no)
- Max batch size
- Max concurrency
- Any custom request headers
From here you can find three types of actions: Edit, Back, or Delete. Once you delete a webhook, the webhook will be permanently deleted.
Error handling
If your webhook endpoint is unreachable, retries are automatically scheduled. When failures persist, the webhook is gradually moved to slower groups. After 24 hours without success, the webhook is disabled.
You will receive notifications when downgrading or disabling occurs. If your endpoint starts responding again, the webhook is automatically upgraded to a faster group. In urgent cases, please contact support.
You will be notified when your webhook is moved to a slower group or disabled due to failures. These notifications appear as system messages in the top right corner of the software, and optionally via email if configured. When your webhook is moved to a slower group, the response delivery is no longer real-time.
Always contact support in case of webhook issues
If your webhook is experiencing issues, you can contact support for help. Risks from a failing endpoint are your own responsibility.