Webhooks
Set up URLs that Euler sends events about alerts, prints and devices to.
A webhook endpoint is a URL in your own software that Euler sends events to. Euler sends an event when a critical alert, a print or a device changes. To get more data about it, use the API.
To get alerts yourself, by email or in Slack, use Notifications instead.
Available on paid plans. Only organization admins can add or change endpoints.
Add an endpoint
Open Integrations & API
In Euler, open SettingsIntegrations & API.
Add the endpoint
Under Webhooks, click Add endpoint. Enter the Endpoint URL, an optional Description, and choose the Events to send. Click Add endpoint.
The URL starts with https:// and must be reachable from the internet. On a self-hosted Euler it can
also be an address on your own network.
Copy the signing secret
The dialog shows the endpoint's Signing secret. The secret is shown only this once, so copy it now. Your software uses it to check that requests come from Euler. See Webhook events.
Send a test event
Open the menu on the endpoint's row and click Send test event. Euler sends a ping event to
the endpoint.
Check deliveries
Open the menu on the endpoint's row and click Deliveries. The list shows each event sent to the endpoint and how the endpoint responded. Click an event to see what was sent, and Resend to send it again.
If every delivery to an endpoint fails for three days, Euler turns the endpoint off and emails your organization's admins. Once the endpoint works again, click Turn on in its menu.
Rotate the signing secret
Open the menu on the endpoint's row and click Rotate secret. Copy the new secret. For the next 24 hours, Euler signs each request with both the old and the new secret, so you have time to update your software. After that, only the new secret works.
Remove an endpoint
Open the menu on the endpoint's row and click Turn off to pause it, or Delete to remove it along with its deliveries.
Next steps
- Webhook events: the events Euler sends, what they contain and how to check them.