List webhook endpoints

GET https://app.speybooks.com/api/v1/webhook-endpoints/

Returns all webhook endpoints for the organisation with their signing secrets and 24-hour delivery statistics. Also includes the complete list of available event types for UI population.

Response

200 Returns all webhook endpoints for the organisation with 24-hour delivery stats and the list of available event types.

Show response fields

availableEvents array<string>

endpoints array<object>

Show child attributes

events array<string>

id integer

isActive boolean

stats24h object

Show child attributes

delivered integer

failed integer

total integer

url string

Request GET /v1/webhook-endpoints/ curl

curl https://api.speybooks.com/v1/webhooks \
  -H "Authorization: Bearer sk_test_..."

Response 200

{
  "success": true,
  "data": {
    "endpoints": [
      {
        "id": 3,
        "url": "https://example.com/webhooks/speybooks",
        "events": [
          "invoice.paid"
        ],
        "isActive": true,
        "stats24h": {
          "total": 15,
          "delivered": 14,
          "failed": 1
        }
      }
    ],
    "availableEvents": [
      "invoice.created",
      "invoice.sent",
      "invoice.paid"
    ]
  }
}