Skip to main content
Juo uses Svix 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 for the full list. Example payload for subscription.created:
{
  "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 to learn how to validate incoming requests.