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

Changed in 19 of the 74 revisions of this API.311461

  • 355991ab86d51See the full diff
    • ●

      added the new app_payment.requires_action enum value to the /// response property for the response status

      response-property-enum-value-added

  • ef86d14ef6911See the full diff
    • ●

      added the new payment.requires_action enum value to the /// response property for the response status

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • ff3a7657356312See the full diff
    • ▲

      for the query request parameter first, default value 20 was added

      request-parameter-default-value-added

    • ●

      for the query request parameter first, the max was set to 100.00

      request-parameter-max-set

    • ●

      for the query request parameter last, the max was set to 100.00

      request-parameter-max-set

  • 1660b8d622041See the full diff
    • ●

      added the new financial_activity.funds_available enum value to the /// response property for the response status

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 918ff9d965e11See the full diff
    • ●

      added the new member.updated enum value to the /// response property for the response status

      response-property-enum-value-added

    This revision's changelog hit the recording limit, so it may not list every change to this endpoint.

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 5fa504e786952See the full diff
    • ●

      added the new account.financing_approved enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new account.financing_denied enum value to the /// response property for the response status

      response-property-enum-value-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 4fe3b2d215462See the full diff
    • ●

      added the new ad.updated enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new ad_campaign.updated enum value to the /// response property for the response status

      response-property-enum-value-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 16c82685be352See the full diff
    • ●

      added the new payment.authorized enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new payment.canceled enum value to the /// response property for the response status

      response-property-enum-value-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 621705ee8f4a3See the full diff
    • ●

      added the new payout.created enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new payout.reversed enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new payout.updated enum value to the /// response property for the response status

      response-property-enum-value-added

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • f1cf47ad0ec21See the full diff
    • ●

      added the new withdrawal.reversed enum value to the /// response property for the response status

      response-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.