×

Webhook Integration

Connect PingView to any service or application with flexible webhook integration. Perfect for custom dashboards, automation workflows, and third-party integrations.

Webhook Integration Features

Custom Payload Format

Send data in JSON format with customizable fields and structure

Authentication Support

Support for API keys, Bearer tokens, and custom authentication headers

Automatic Retries

Built-in retry mechanism with exponential backoff for failed requests

Secure Delivery

HTTPS-only delivery with request signing for enhanced security

Popular Use Cases

Custom Dashboards

Feed monitoring data to your custom dashboards and analytics platforms

Mobile Apps

Send push notifications through your mobile app backend

Third-party Services

Integrate with any service that accepts HTTP webhooks

Setup Your Webhook Integration

1

Prepare Your Endpoint

Set up an HTTP endpoint that can receive POST requests

Your endpoint should accept JSON payloads and return HTTP 200-299 for successful processing

2

Configure Authentication

Set up authentication if your endpoint requires it

Supports API keys in headers, Bearer tokens, or custom authentication schemes

3

Add Webhook URL

Enter your webhook URL in PingView notification settings

Go to Monitor Settings > Notifications > Add Webhook Integration

4

Test Integration

Send a test webhook to verify everything works correctly

Use our test feature to ensure your endpoint receives and processes alerts properly

Sample Webhook Payload

{
  "event": "monitor.down",
  "timestamp": "2024-01-15T10:30:00Z",
  "monitor": {
    "id": "mon_123456789",
    "name": "Production API",
    "url": "https://api.example.com/health",
    "type": "http"
  },
  "incident": {
    "id": "inc_987654321",
    "status": "down",
    "started_at": "2024-01-15T10:30:00Z",
    "duration": 0,
    "error": {
      "code": "CONNECTION_TIMEOUT",
      "message": "Connection timeout after 30 seconds"
    }
  },
  "location": {
    "region": "us-east-1",
    "country": "United States"
  },
  "response_time": null,
  "status_code": null
}

This is a sample payload for a "down" event. Recovery events include additional fields like resolution time.

Authentication Examples

API Key

Header:
X-API-Key: your-secret-key

Bearer Token

Header:
Authorization: Bearer token123

Custom Header

Header:
X-Custom-Auth: custom-value

Technical Details

Request Details

  • POST requests only
  • JSON content-type
  • HTTPS recommended
  • User-Agent: PingView/1.0

Response Handling

  • Success: HTTP 200-299
  • Timeout: 30 seconds
  • Retry: 3 attempts
  • Backoff: Exponential

Frequently Asked Questions

What happens if my webhook endpoint is down?

We'll retry failed webhooks up to 3 times with exponential backoff. If all retries fail, we'll log the failure and move on to prevent blocking other notifications.

Can I verify that webhooks are coming from PingView?

Yes! Each webhook includes a signature header that you can verify using HMAC-SHA256. We also provide IP ranges for additional filtering.

Is there a rate limit on webhook deliveries?

No rate limits on legitimate webhook deliveries. However, we do implement reasonable limits to prevent abuse and protect your endpoints.

Start Building Custom Integrations

Webhooks give you unlimited flexibility to integrate PingView with any system or workflow. Get started today and build the perfect monitoring solution for your needs.

Webhook Integration - PingView Uptime Monitoring