Sign in

a84d4905fdbb

latestOpenAPI 3.1.02026-08-143874115.7 MB
Webhooks

List Webhooks

Returns a paginated list of webhook endpoints configured for an account, ordered by most recently created.

get/webhooks

Query parameters

account_idstring required

The unique identifier of the account to list webhooks for.

app_idstring

Only return webhooks attached to this app. Omit to list the account's own webhooks.

include_app_webhooksboolean

Also return webhooks attached to the account's apps, not just the account's own. Cannot be combined with app_id.

has_failuresboolean

Only return webhooks whose endpoint is currently failing — every delivery since the current failure streak began has been rejected. Clears as soon as a delivery succeeds.

firstinteger

The number of webhooks to return (default 20, max 100).

afterstring

A cursor; returns webhooks after this position.

lastinteger

The number of webhooks to return from the end of the range.

beforestring

A cursor; returns webhooks before this position.

Response

webhooks listed

Example response

{
  "data": [
    {
      "api_version": "v1",
      "api_version_date": "2026-01-01",
      "created_at": "2026-01-01T12:00:00.000Z",
      "disabled_at": "2026-01-01T12:00:00.000Z",
      "disabled_reason": "delivery_failures",
      "events": [
        "payment.succeeded"
      ],
      "failing_since": "2026-01-01T12:00:00.000Z",
      "id": "hook_xxxxxxxxxxxxxx",
      "last_failure_at": "2026-01-01T12:00:00.000Z",
      "resource_id": "biz_xxxxxxxxxxxxxx",
      "url": "https://example.com/shine-time/whop",
      "webhook_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
  ],
  "page_info": {
    "end_cursor": "WyJjdXJzb3IiLDFd",
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}