Webhook

Connect your custom webhooks to PagerTree using our Webhook integration. Connects with most devops and monitoring tools.

What is the Webhook Integration?

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.

How It Works

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.

Integration Walkthrough

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.

In PagerTree

  1. Create the integration by clicking the Webhook logo.

In Other Application - Configure the Webhook

The calling application must send a POST request with a Content-Type: application/json. The body of the request should have the following values.

Example Request # 1

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"
}

Example Request #2

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.

Integration Options

Last updated