Configure and receive events for actions users are taking.
Whenever a user takes an action at Runops, we send events to a third party provider, that will take care of delivering this events to your own endpoint.
This can be used to build your custom dashboards or analytics upon this data.
Webhooks are delivered via HTTPS requests. To receive them, you have to provide a valid URL that accepts a POST request. You must be able to receive, parse, and validate those requests.
We use svix as our webhooks provider, and you don't need to create an account.
As an admin, go to our portal, on settings page and click
You will be redirected to the svix App Portal, where you can setup your endpoint.
Check the provider docs on how to configure one or more endpoints to receive the events.
You must be sure that the request came from the trusted provider to avoid impersonation and replay attacks.
You can do this validating the request signature. In the endpoint configuration page, you can find the
Use that signature secret to validate the request. Do not share this secret with anyone.
Check how to validate the signature.
The following events are available to be delivered as webhooks. All events are wrapped in the following strucuture:
Each event will contain different
data structure, as following: