Sign in
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

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

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": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes