Use webhooks
Using webhooks for Skedulo events.
Webhooks are a way for you to listen for specific events or changes that occur to your Skedulo data. When a change occurs, you can configure webhooks to notify other applications or take actions in response in real time. This functionality is useful for
Skedulo supports two different implementations of webhooks – webhooks and triggered actions via two of our Lens API endpoints, /webhooks
and /triggered-actions
.
Triggered actions are Skedulo’s new iteration of webhooks and will eventually replace the legacy webhook functionality.
Webhooks/triggered actions are a configuration that causes a web (HTTPS) request to be made when a specific condition is met. These requests are sent as a JSON payload, which can be used to execute specific actions in response.
Configuration consists of a name
, a URL
, and a GraphQL query.
These configurations instruct the Skedulo platform to perform an action when a data change or other event occurs. Defined EQL filters limit the cases that generate an action, and these filters are mandatory for triggered actions, but optional for webhooks.
Whether you use a webhook or a triggered action depends on your use case, as there are a number of features that are only available using one implementation or the other, but not both.
Certain features are only available using either triggered actions or webhooks, but not available for both.
Feature | Triggered Actions | Webhooks |
---|---|---|
Include the previous data for a modified object. | ❌ | ✅ |
Include the contents of a deleted object. | ❌ | ✅ |
Query can retrieve extra data from the database after a trigger is fired. | ✅ | ❌ |
Trigger on inbound SMS (must be sent to the Skedulo-allocated customer SMS route number). | ❌ | ✅ |
Send an SMS when triggered. | ✅ | ❌ |
Execute after a time offset (deferred action). | ✅ | ✅ |
Execute on a schedule (cron job). | ❌ | ✅ |
Authorization
header using the Bearer
method.$AUTH_TOKEN
environment variable to represent the API token.
See Admin Settings: API tokens for more information about how to obtain an API token.
Content-Type: application/json
in the API request header when creating a webhook.Using webhooks for Skedulo events.
Perform actions in response to Skedulo event triggers.
Using webhooks to manage incoming SMS related to jobs
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.