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

# Overview

> How Juo webhooks work and how to subscribe to them

Juo uses [Svix](https://svix.com) to deliver webhooks reliably. When subscription-related events occur in your store, Juo sends an HTTP POST request to your configured endpoint with a JSON payload.

## Setting up

1. Open the Juo Admin Portal and navigate to **Settings → Webhooks**
2. Click **Manage Webhooks** to open the Svix dashboard
3. Add your endpoint URL and select which events to subscribe to

## Delivery guarantees

* **At-least-once delivery** — webhooks are retried on failure
* **Retry schedule** — exponential backoff over 5 days
* **Message history** — view delivery logs in the dashboard

## Payload structure

All webhook payloads are JSON objects. Each event type has a defined schema — see [Topics](/docs/api-reference/admin/webhooks/topics) for the full list.

**Example payload for `subscription.created`:**

```json theme={null}
{
  "id": "a1b2c3d4-e5f6-...",
  "resource": "subscription",
  "status": "active",
  "currencyCode": "USD",
  "nextBillingDate": "2026-04-01T00:00:00.000Z",
  "currentCycle": 1,
  "customer": "cust-id-or-object",
  "items": [...],
  "discounts": [],
  "deliveryPrice": 0,
  "createdAt": "2026-03-01T00:00:00.000Z",
  "updatedAt": "2026-03-01T00:00:00.000Z"
}
```

## Signature verification

All webhooks are signed by Svix. See [Signature Verification](/docs/api-reference/admin/webhooks/signature-verification) to learn how to validate incoming requests.