> ## 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.

# API Webhooks

> Un webhook est un endpoint sur votre serveur auquel Whop envoie des requêtes HTTP POST signées lorsque des événements se produisent, comme un paiement réussi ou une adhésion qui devient active.

Un webhook est rattaché à un compte ou à une app et s'abonne aux événements que vous choisissez.

Utilisez l'API Webhooks pour créer et mettre à jour des endpoints, envoyer un événement de test, consulter le journal des livraisons et rejouer les livraisons que votre serveur a manquées. Consultez [Webhooks et événements](https://docs.whop.com/fr/developer/guides/webhooks.md) pour vérifier les signatures et gérer les nouvelles tentatives.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les webhooks](https://docs.whop.com/fr/api-reference/webhooks/list-webhooks.md) | GET `/webhooks` |
| [Récupérer un webhook](https://docs.whop.com/fr/api-reference/webhooks/retrieve-webhook.md) | GET `/webhooks/{id}` |
| [Lister les livraisons](https://docs.whop.com/fr/api-reference/webhooks/list-deliveries.md) | GET `/webhooks/{id}/deliveries` |
| [Créer un webhook](https://docs.whop.com/fr/api-reference/webhooks/create-webhook.md) | POST `/webhooks` |
| [Rejouer une livraison](https://docs.whop.com/fr/api-reference/webhooks/replay-delivery.md) | POST `/webhooks/{id}/deliveries/{delivery_id}/replay` |
| [Rejouer les livraisons d'une période](https://docs.whop.com/fr/api-reference/webhooks/replay-deliveries-in-a-range.md) | POST `/webhooks/{id}/replay` |
| [Envoyer un événement de test](https://docs.whop.com/fr/api-reference/webhooks/send-test-event.md) | POST `/webhooks/{id}/test` |
| [Mettre à jour un webhook](https://docs.whop.com/fr/api-reference/webhooks/update-webhook.md) | PATCH `/webhooks/{id}` |
| [Supprimer un webhook](https://docs.whop.com/fr/api-reference/webhooks/delete-webhook.md) | DELETE `/webhooks/{id}` |

## Attributs

**id** `string` *required*

ID du webhook, préfixé par `hook_`.

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

La version de l'API utilisée pour formater les payloads envoyés à cet endpoint de webhook.

Options disponibles : `v1`, `v2`, `v5`

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

La version datée de l'API (Api-Version-Date) à laquelle sont figés les payloads v1 de cet endpoint : les événements sont sérialisés exactement comme une lecture REST à cette version (avec le sérialiseur natif lorsque la ressource en possède un). Null lorsqu'elle n'est pas figée — webhooks legacy (v2/v5), et webhooks v1 utilisant l'ancienne forme de payload.

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

Indique si des événements sont envoyés pour les ressources enfants. Par exemple, si le webhook est sur un compte, l'activer envoie uniquement les événements de ses sous-comptes.

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

Nombre de livraisons consécutives dont la première tentative vers cet endpoint a échoué depuis la dernière livraison acceptée. Les nouvelles tentatives ultérieures de la même livraison ne l'incrémentent pas. Revient à `0` lorsqu'une livraison réussit ou que le webhook est réactivé.

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

Date de création du webhook, sous forme d'horodatage ISO 8601.

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

Date à laquelle Whop a automatiquement désactivé ce webhook, sous forme d'horodatage ISO 8601. `null` sauf si le webhook a été désactivé par Whop ; un webhook que vous avez désactivé vous-même a `enabled: false` et un `disabled_at` à `null`.

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

Raison pour laquelle Whop a désactivé ce webhook. `delivery_failures` signifie que toutes les livraisons ont échoué pendant 3 jours consécutifs. `null` lorsque `disabled_at` vaut `null`.

Options disponibles : `delivery_failures`

**enabled** `boolean` *required*

Indique si cet endpoint de webhook est actuellement actif et reçoit des événements.

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

Types d'événements auxquels ce webhook est abonné, en notation pointée (par exemple `payment.succeeded`).

Options disponibles : `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*

Date de début de la série d'échecs en cours, sous forme d'horodatage ISO 8601. Contrairement à `last_failure_at`, elle est définie lors de la première tentative échouée de la série, et indique donc un endpoint en échec en ce moment. `null` lorsque l'endpoint fonctionne correctement.

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

Date du dernier échec d'une livraison vers cet endpoint après épuisement des nouvelles tentatives, sous forme d'horodatage ISO 8601. `null` si aucune livraison n'a jamais échoué.

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

ID de la ressource (compte ou app) à laquelle ce webhook est rattaché.

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

Le sous-ensemble des types d'événements abonnés qui prennent en charge l'envoi de payloads de test, en notation pointée.

Options disponibles : `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*

Un libellé pour cet endpoint de webhook, tel que `Production`, affiché dans le tableau de bord. `null` si aucun titre n'a été défini.

**url** `string` *required*

URL de destination où les payloads de webhook sont livrés via HTTP POST.

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

Clé secrète utilisée pour signer les payloads de webhook. Utilisez-la pour vérifier la signature HMAC de chaque livraison. Renvoyée dans la réponse de création. `null` lors des lectures ultérieures par des clés API et des apps OAuth.

```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/fr/developer/guides/webhooks.md)
- [Webhook](https://docs.whop.com/fr/api-reference/legacy/webhooks/webhook.md)
- [Create webhook](https://docs.whop.com/fr/api-reference/legacy/webhooks/create-webhook.md)
