Documentation

Complete guide to webhooks, debugging, and real-time event monitoring with HookMetry

API Reference

Authentication Required

All API requests require JWT token in Authorization header

Authentication

Authorization: Bearer YOUR_JWT_TOKEN

Create Endpoint

POST /api/endpoints

Request Body:

{
  "name": "My Stripe Webhook",
  "validationType": "stripe",
  "webhookSecret": "whsec_abc123..."
}

Response (200 OK):

{
  "success": true,
  "data": {
    "id": "ep_abc123",
    "url": "https://hookmetry.com/webhook/ep_abc123",
    "validationType": "stripe",
    "createdAt": "2023-03-01T12:00:00Z"
  }
}

List Webhooks

GET /api/webhooks?endpointId=ep_abc123&limit=20&offset=0

Response (200 OK):

{
  "success": true,
  "data": {
    "webhooks": [...],
    "total": 150,
    "hasMore": true
  }
}

Replay Webhook

POST /api/webhooks/:id/replay

Request Body:

{
  "targetUrl": "https://yourserver.com/webhook"
}

Response (200 OK):

{
  "success": true,
  "data": {
    "status": 200,
    "responseTime": 124
  }
}