This article explains how to create a webhook notification channel so PulseAPI can send JSON payloads to any URL when incidents are created or resolved. Use webhooks to integrate with PagerDuty, Opsgenie, custom incident systems, or any service that accepts HTTP POST requests.

Prerequisites: Webhook notifications require a Starter, Professional, or Team plan.

Step 1: Prepare Your Webhook URL

Before setting up the channel in PulseAPI, have your target URL ready. This is the URL that will receive the HTTP POST request.

Examples:

• A PagerDuty Events API v2 endpoint
• A custom API endpoint you control
• An Opsgenie webhook URL
• A Make (formerly Integromat) or Zapier webhook trigger

The endpoint must accept POST requests and return an HTTP 2xx response. PulseAPI considers any non-2xx response a delivery failure.

Step 2: Create the Webhook Channel

1. In the left sidebar, click Alerts.
2. Click Notification Channels.
3. Click New Channel.
4. Select Webhook as the channel type.
5. Enter a Name for the channel (e.g., "PagerDuty Webhook").
6. Enter your Webhook URL.
7. Leave Active toggled on.
8. Click Create Channel.

Step 3: Test the Webhook

1. On the channel list, find your new webhook channel.
2. Click Send Test Notification.
3. PulseAPI sends a test payload to your URL. Check your target system to confirm it was received and processed correctly.

If the test fails, confirm your URL is publicly accessible and returns 2xx.

Step 4: Assign to an Alert Rule

1. Go to Alerts → Alert Rules.
2. Open or create an alert rule.
3. In the Notification Channels field, select your webhook channel.
4. Save the rule.

Webhook Payload Format

PulseAPI sends a JSON payload. Here's an example incident creation payload:

{
  "event": "incident.created",
  "incident": {
    "id": 1234,
    "title": "Production API — Status code 503",
    "status": "open",
    "severity": "critical",
    "started_at": "2026-04-16T14:23:00Z"
  },
  "monitor": {
    "id": 42,
    "name": "Production API",
    "url": "https://api.yourapp.com/health"
  },
  "team": {
    "id": 7,
    "name": "Acme Corp"
  }
}

For incident resolution, the event field is "incident.resolved" and additional fields include resolved_at and duration_seconds.

For the full field reference, see Webhook Payload Reference.

Related Articles

• Webhook Payload Reference
• Testing a Notification Channel
• How Notification Channels Work
• Creating an Alert Rule

Still have questions? Contact support.