> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Webhooks API

> Een Webhook is een endpoint op je server waarnaar Whop ondertekende HTTP POST-verzoeken stuurt wanneer er events plaatsvinden, zoals een geslaagde betaling of een membership die actief wordt.

Een webhook is gekoppeld aan een account of een app en abonneert zich op de events die je kiest.

Gebruik de Webhooks API om endpoints aan te maken en bij te werken, een test-event te verzenden, het afleveringslogboek te bekijken en afleveringen opnieuw af te spelen die je server heeft gemist. Zie [Webhooks & Events](https://docs.whop.com/nl/developer/guides/webhooks.md) voor het verifiëren van handtekeningen en het afhandelen van nieuwe pogingen.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Webhooks opvragen](https://docs.whop.com/nl/api-reference/webhooks/list-webhooks.md) | GET `/webhooks` |
| [Webhook ophalen](https://docs.whop.com/nl/api-reference/webhooks/retrieve-webhook.md) | GET `/webhooks/{id}` |
| [Deliveries opvragen](https://docs.whop.com/nl/api-reference/webhooks/list-deliveries.md) | GET `/webhooks/{id}/deliveries` |
| [Webhook aanmaken](https://docs.whop.com/nl/api-reference/webhooks/create-webhook.md) | POST `/webhooks` |
| [Delivery opnieuw afspelen](https://docs.whop.com/nl/api-reference/webhooks/replay-delivery.md) | POST `/webhooks/{id}/deliveries/{delivery_id}/replay` |
| [Deliveries in een bereik opnieuw afspelen](https://docs.whop.com/nl/api-reference/webhooks/replay-deliveries-in-a-range.md) | POST `/webhooks/{id}/replay` |
| [Test-event verzenden](https://docs.whop.com/nl/api-reference/webhooks/send-test-event.md) | POST `/webhooks/{id}/test` |
| [Webhook bijwerken](https://docs.whop.com/nl/api-reference/webhooks/update-webhook.md) | PATCH `/webhooks/{id}` |
| [Webhook verwijderen](https://docs.whop.com/nl/api-reference/webhooks/delete-webhook.md) | DELETE `/webhooks/{id}` |

## Attributen

**id** `string` *required*

Webhook-ID, met prefix `hook_`.

**api\_version** `string` *required*

De API-versie die wordt gebruikt om payloads op te maken die naar dit webhook-endpoint worden verzonden.

Beschikbare opties: `v1`, `v2`, `v5`

**api\_version\_date** `string | null` *required*

De gedateerde API-versie (Api-Version-Date) waaraan v1-payloads voor dit endpoint zijn vastgezet: events worden precies geserialiseerd zoals een REST-read in deze versie (de native serializer waar de resource er een heeft). Null wanneer niet vastgezet — legacy (v2/v5) webhooks, en v1-webhooks met de legacy payloadvorm.

**child\_resource\_events** `boolean` *required*

Of er events worden verzonden voor onderliggende resources. Als de webhook bijvoorbeeld op een account staat, worden met deze instelling alleen events van de subaccounts verzonden.

**consecutive\_failures** `integer` *required*

Aantal opeenvolgende afleveringen waarvan de eerste poging naar dit endpoint is mislukt sinds het er voor het laatst een accepteerde. Latere nieuwe pogingen van dezelfde aflevering verhogen dit niet. Wordt teruggezet naar `0` wanneer een aflevering slaagt of de webhook opnieuw wordt ingeschakeld.

**created\_at** `string` *required*

Wanneer de webhook is aangemaakt, als ISO 8601-tijdstempel.

**disabled\_at** `string | null` *required*

Wanneer Whop deze webhook automatisch heeft uitgeschakeld, als ISO 8601-tijdstempel. `null` tenzij de webhook door Whop is uitgeschakeld; een webhook die je zelf hebt uitgeschakeld heeft `enabled: false` en een `disabled_at` van `null`.

**disabled\_reason** `string | null` *required*

Waarom Whop deze webhook heeft uitgeschakeld. `delivery_failures` betekent dat elke aflevering 3 dagen achter elkaar is mislukt. `null` wanneer `disabled_at` `null` is.

Beschikbare opties: `delivery_failures`

**enabled** `boolean` *required*

Of dit webhook-endpoint momenteel actief is en events ontvangt.

**events** `string[]` *required*

Eventtypes waarop deze webhook is geabonneerd, in puntnotatie (bijvoorbeeld `payment.succeeded`).

Beschikbare opties: `account.updated`, `account.financing_approved`, `account.financing_denied`, `account.financing_disabled`, `invoice.created`, `invoice.marked_uncollectible`, `invoice.paid`, `invoice.past_due`, `invoice.voided`, `membership.activated`, `membership.deactivated`, `membership.trial_ending_soon`, `membership.updated`, `entry.created`, `entry.approved`, `entry.denied`, `entry.deleted`, `export.completed`, `export.failed`, `setup_intent.requires_action`, `setup_intent.succeeded`, `setup_intent.canceled`, `ledger_account.funds_available`, `swap.completed`, `deposit.succeeded`, `financial_activity.funds_available`, `transfer.created`, `transfer.completed`, `transfer.failed`, `withdrawal.created`, `withdrawal.updated`, `withdrawal.reversed`, `payout.created`, `payout.updated`, `payout.reversed`, `card_transaction.created`, `card_transaction.updated`, `card_transaction.completed`, `card_transaction.declined`, `card_transaction.reversed`, `card.created`, `card.updated`, `card.frozen`, `card.canceled`, `card_application.created`, `card_application.updated`, `card_application.approved`, `card_application.denied`, `course_lesson_interaction.completed`, `domain.created`, `domain.updated`, `domain.deleted`, `capital.created`, `capital.updated`, `payout_method.created`, `verification.succeeded`, `identity_profile.approved`, `identity_profile.rejected`, `identity_profile.needs_action`, `identity_profile.updated`, `payout_account.status_updated`, `payment.authorized`, `payment.canceled`, `resolution_center_case.created`, `resolution_center_case.updated`, `resolution_center_case.decided`, `product.created`, `product.updated`, `product.deleted`, `product.published`, `product.unpublished`, `plan.created`, `plan.updated`, `plan.deleted`, `shipment.created`, `shipment.updated`, `member.created`, `member.updated`, `ad_campaign.created`, `ad_campaign.payment_failed`, `ad_campaign.updated`, `ad_campaign.events`, `ad_campaign.deleted`, `ad_group.created`, `ad_group.updated`, `ad_group.deleted`, `ad.created`, `ad.updated`, `ad.deleted`, `app_installation.created`, `app_installation.deleted`, `events.created`, `chat.message.created`, `chat.reaction.created`, `payment.created`, `payment.succeeded`, `payment.failed`, `payment.pending`, `payment.requires_action`, `dispute.created`, `dispute.updated`, `refund.created`, `refund.updated`, `dispute_alert.created`, `membership.cancel_at_period_end_changed`, `membership.went_valid`, `membership.went_invalid`, `membership.metadata_updated`, `resolution.created`, `resolution.updated`, `resolution.decided`, `payment.affiliate_reward_created`, `membership.experience_claimed`, `app_membership.went_valid`, `app_membership.went_invalid`, `app_payment.created`, `app_payment.succeeded`, `app_payment.failed`, `app_payment.pending`, `app_payment.requires_action`, `app_membership.cancel_at_period_end_changed`, `shipping_address.changed`

**failing\_since** `string | null` *required*

Wanneer de huidige reeks mislukkingen begon, als ISO 8601-tijdstempel. In tegenstelling tot `last_failure_at` wordt dit ingesteld bij de eerste mislukte poging van de reeks, zodat het een endpoint toont dat op dit moment faalt. `null` wanneer het endpoint gezond is.

**last\_failure\_at** `string | null` *required*

Wanneer een aflevering naar dit endpoint voor het laatst is mislukt nadat alle nieuwe pogingen waren uitgeput, als ISO 8601-tijdstempel. `null` als er nog nooit een aflevering is mislukt.

**resource\_id** `string` *required*

ID van de resource (account of app) waaraan deze webhook is gekoppeld.

**testable\_events** `string[]` *required*

De subset van geabonneerde eventtypes die het verzenden van testpayloads ondersteunen, in puntnotatie.

Beschikbare opties: `account.updated`, `account.financing_approved`, `account.financing_denied`, `account.financing_disabled`, `invoice.created`, `invoice.marked_uncollectible`, `invoice.paid`, `invoice.past_due`, `invoice.voided`, `membership.activated`, `membership.deactivated`, `membership.trial_ending_soon`, `membership.updated`, `entry.created`, `entry.approved`, `entry.denied`, `entry.deleted`, `export.completed`, `export.failed`, `setup_intent.requires_action`, `setup_intent.succeeded`, `setup_intent.canceled`, `ledger_account.funds_available`, `swap.completed`, `deposit.succeeded`, `financial_activity.funds_available`, `transfer.created`, `transfer.completed`, `transfer.failed`, `withdrawal.created`, `withdrawal.updated`, `withdrawal.reversed`, `payout.created`, `payout.updated`, `payout.reversed`, `card_transaction.created`, `card_transaction.updated`, `card_transaction.completed`, `card_transaction.declined`, `card_transaction.reversed`, `card.created`, `card.updated`, `card.frozen`, `card.canceled`, `card_application.created`, `card_application.updated`, `card_application.approved`, `card_application.denied`, `course_lesson_interaction.completed`, `domain.created`, `domain.updated`, `domain.deleted`, `capital.created`, `capital.updated`, `payout_method.created`, `verification.succeeded`, `identity_profile.approved`, `identity_profile.rejected`, `identity_profile.needs_action`, `identity_profile.updated`, `payout_account.status_updated`, `payment.authorized`, `payment.canceled`, `resolution_center_case.created`, `resolution_center_case.updated`, `resolution_center_case.decided`, `product.created`, `product.updated`, `product.deleted`, `product.published`, `product.unpublished`, `plan.created`, `plan.updated`, `plan.deleted`, `shipment.created`, `shipment.updated`, `member.created`, `member.updated`, `ad_campaign.created`, `ad_campaign.payment_failed`, `ad_campaign.updated`, `ad_campaign.events`, `ad_campaign.deleted`, `ad_group.created`, `ad_group.updated`, `ad_group.deleted`, `ad.created`, `ad.updated`, `ad.deleted`, `app_installation.created`, `app_installation.deleted`, `events.created`, `chat.message.created`, `chat.reaction.created`, `payment.created`, `payment.succeeded`, `payment.failed`, `payment.pending`, `payment.requires_action`, `dispute.created`, `dispute.updated`, `refund.created`, `refund.updated`, `dispute_alert.created`, `membership.cancel_at_period_end_changed`, `membership.went_valid`, `membership.went_invalid`, `membership.metadata_updated`, `resolution.created`, `resolution.updated`, `resolution.decided`, `payment.affiliate_reward_created`, `membership.experience_claimed`, `app_membership.went_valid`, `app_membership.went_invalid`, `app_payment.created`, `app_payment.succeeded`, `app_payment.failed`, `app_payment.pending`, `app_payment.requires_action`, `app_membership.cancel_at_period_end_changed`, `shipping_address.changed`

**title** `string | null` *required*

Een label voor dit webhook-endpoint, zoals `Production`, dat in het dashboard wordt getoond. `null` als er geen titel is ingesteld.

**url** `string` *required*

Bestemmings-URL waarnaar webhook-payloads via HTTP POST worden afgeleverd.

**webhook\_secret** `string | null` *required*

Geheime sleutel die wordt gebruikt om webhook-payloads te ondertekenen. Gebruik deze om de HMAC-handtekening van elke aflevering te verifiëren. Wordt geretourneerd in de create-respons. `null` bij latere reads door API-sleutels en OAuth-apps.

```json Webhook theme={null}
{
	"id": "hook_xxxxxxxxxxxxxx",
	"resource_id": "biz_xxxxxxxxxxxxxx",
	"title": "Production",
	"url": "https://example.com/webhooks/whop",
	"enabled": true,
	"api_version": "v1",
	"api_version_date": "2026-09-01",
	"events": ["payment.succeeded", "membership.activated"],
	"child_resource_events": false,
	"testable_events": ["payment.succeeded", "membership.activated"],
	"consecutive_failures": 0,
	"failing_since": null,
	"last_failure_at": "2026-08-28T03:12:45.000Z",
	"disabled_at": null,
	"disabled_reason": null,
	"created_at": "2026-08-02T18:20:00.000Z",
	"webhook_secret": null
}
```


## Related topics

- [Webhooks](https://docs.whop.com/nl/developer/guides/webhooks.md)
- [Identityprofile updated](https://docs.whop.com/nl/api-reference/verifications/identityprofile-updated.md)
- [Card application approved](https://docs.whop.com/nl/api-reference/cards/card-application-approved.md)
