Webhook Integration Guide
|Logo||Company||Estimated Time||Functionality||Vendor Docs|
Webhooks are user defined HTTP callbacks. They are usually triggered by some event, and when that event occurs, the source site makes an HTTP request to the URI configured for the webhook.
|Note||This documentation is meant for webhooks that are incoming into PagerTree. If you are looking for outgoing webhooks, please refer to the documentation here.|
Webhooks are versatile user-defined callbacks that many applications support. PagerTree acts as the dispatcher for these callbacks, determining the right people to notify based on on-call schedules. PagerTree notifies them via email, sms, voice, and/or push notifications until the alert is acknowledged or closed.
The Webhook integration is one-way, meaning:
- When the payload event_type is create (
event_type === "create"), an alert is created in PagerTree automatically.
- When the payload event_type is acknowledge (
event_type === "acknowledge"), an alert is acknowledged in PagerTree automatically.
- When the payload event_type is resolved (
event_type === "resolve"), the alert is resolved in PagerTree automatically.
In this integration tutorial we will show you how to send a Webhook into PagerTree. The estimated time for this integration is 10 minutes. We assume that you already have a PagerTree account setup.
- From the action button, click the “Create Integration” button.
- In the “Create Integration” box, fill out the following:
- Name of the Integration.
- Select the Type to Webhook
- Select an appropriate Urgency for when this integration is triggered
- Select the Team this alert will be assigned to
- Click Save
- Copy the Endpoint URL
The calling application must send a POST request with a Content-Type: application/json. The body of the request should have the following values.
|Id||string||a unique id|
You have successfully completed the Webhook Integration. Now when a webhook is triggered, PagerTree will create an alert and route it to the correct team member that is on-call. If you have any questions please contact firstname.lastname@example.org