Webhook
Connect your custom webhooks to PagerTree using our Webhook integration. Connects with most devops and monitoring tools.
Company | Estimated Time | Vendor Docs | Open Source |
---|---|---|---|
PagerTree LLC | 10 minutes | |
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.
If your tool is not listed on our integrations page, the webhook integration is a great choice to use as an integration point since most tools support sending webhooks for alerts and alarms.
This documentation is meant for webhooks that are incoming into PagerTree. If you are looking for outgoing webhooks, please refer to the outgoing webhook documentation.
Webhooks are versatile user-defined callbacks that many applications support.
- 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.
- 1.
The calling application must send a POST request with a Content-Type: application/json. The body of the request should have the following values.
Field | Type | Valid Values |
---|---|---|
event_type | string | create|acknowledge|resolve |
Id | string | a unique id |
Title | string | (non-empty) |
Description | string | (non-empty) |
Tags | string array | (optional) |
Meta | map | (optional) |
POST /integration/int_ODCWagoG9 HTTP/1.1
Host: api.pagertree.com
Content-Type: application/json
{
"event_type": "create",
"Id": "example-id-123",
"Title": "Example Incident Title",
"Description": "Example Incident Description"
}
POST /integration/int_ODCWagoG9 HTTP/1.1
Host: api.pagertree.com
Content-Type: application/json
{
"event_type": "create",
"Id": "example-id-123",
"Title": "Example Incident Title",
"Description": "Example Incident Description",
"Tags": [
"a",
"b",
"c"
],
"Meta": {
"incident": true,
"incident_severity": "SEV-1",
"incident_message": "Please join conference bridge 1-800-123-4567"
}
}
You have successfully completed the Webhook Integration.
Option | Description | Default |
---|---|---|
Token | The token can be used to authenticate request. Must be passed in by requesting clients in the pagertree-token HTTP header. | |
Capture Additional Data | Should PagerTree capture and display other data sent? | False |
Last modified 5mo ago