> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ordergroove.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ordergroove.com/_mcp/server.

# Webhooks Overview

Ordergroove webhooks let you subscribe to events that happen within the platform — subscription creation, order placement, payment updates, cancellations, and more — and receive HTTP POST notifications to a URL of your choosing in real time.

***

## How Webhooks Work

When a subscribed event occurs in Ordergroove, we send an HTTP POST request to the endpoint URL you've configured. The request body contains a JSON payload describing the event and the associated data.

Your endpoint should return a `2xx` response to acknowledge receipt. If we don't receive one, Ordergroove will retry delivery.

***

## Authentication

All webhook payloads are signed so you can verify they originated from Ordergroove. We support two signing methods:

* **HMAC-SHA256** — a hash-based signature included in the request headers
* **AES encryption** — payload-level encryption for an additional layer of security

See [HMAC and AES Authentication](/docs/data/hmac-auth) for implementation details.

***

## Configuring Webhooks

Webhooks can be configured through the Ordergroove dashboard or programmatically via the API.

* For the full list of available events and the configuration API reference, see the endpoint documentation in this section.
* For a step-by-step setup walkthrough, see [Configure Webhooks via API](/docs/data/configure-webhooks).

***

## Legacy Webhooks

If your integration was built before the current Webhooks API, you may be using the legacy webhook system. See [Webhooks Overview (Legacy)](/docs/data/webhooks-legacy) for documentation on the older format, and [Configure Webhooks via API](/docs/data/configure-webhooks) for migration guidance.

***

## Related Guides

| Guide                                                                              | Description                                   |
| ---------------------------------------------------------------------------------- | --------------------------------------------- |
| [HMAC and AES Authentication](/docs/data/hmac-auth)                                | Verify webhook payloads are from Ordergroove  |
| [Webhooks Overview (Legacy)](/docs/data/webhooks-legacy)                           | Legacy webhook format and event list          |
| [Configure Webhooks via API](/docs/data/configure-webhooks)                        | Register and manage webhook endpoints         |
| [Expiring or Termed Subscriptions Using Webhooks](/docs/data/termed-subscriptions) | Handle subscription expiry events             |
| [Using Webhooks for 1-Click Actions](/docs/lifecycle/order/webhooks-1-click)       | Trigger upsell and action flows from webhooks |