List Webhooks

Retrieve a paginated list of configured webhooks.

Endpoint

GET /v1/webhooks

Authentication

Requires an API key with the webhooks:read scope.

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number
per_page	integer	15	Items per page (max 100)

Response

Success (200 OK)

{
  "data": [
    {
      "id": 1,
      "name": "Booking Notifications",
      "url": "https://example.com/webhooks/bookings",
      "events": ["booking.created", "booking.updated", "booking.cancelled"],
      "is_active": true,
      "failure_count": 0,
      "last_triggered_at": "2026-01-15T10:30:00+00:00",
      "created_at": "2025-06-01T00:00:00+00:00",
      "updated_at": "2026-01-15T10:30:00+00:00"
    },
    {
      "id": 2,
      "name": "Payment Sync",
      "url": "https://example.com/webhooks/payments",
      "events": ["payment.received", "payment.refunded"],
      "is_active": true,
      "failure_count": 2,
      "last_triggered_at": "2026-01-14T15:45:00+00:00",
      "created_at": "2025-08-15T00:00:00+00:00",
      "updated_at": "2026-01-14T15:45:00+00:00"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 2,
    "total_pages": 1,
    "request_id": "req_abc123",
    "timestamp": "2026-01-15T12:00:00+00:00"
  }
}

Response Fields

Field	Type	Description
id	integer	Unique webhook identifier
name	string	Webhook name
url	string	Endpoint URL that receives events
events	array	List of subscribed event types
is_active	boolean	Whether webhook is active
failure_count	integer	Consecutive delivery failures
last_triggered_at	string|null	Last event sent (ISO 8601)
created_at	string	ISO 8601 datetime
updated_at	string	ISO 8601 datetime

Auto-Disable

Webhooks are automatically disabled after 10 consecutive delivery failures. The failure_count resets to 0 after a successful delivery.

Errors

Status	Code	Description
401	authentication_required	No API key provided
401	invalid_api_key	Invalid API key
403	insufficient_scope	API key lacks webhooks:read scope

Example Request

curl -X GET "https://app.equipdash.com/api/v1/webhooks" \
  -H "Authorization: Bearer eqd_live_abc123xyz789..."