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

# Subscription Payload Reference

> JSON payload reference for subscription webhook events

JSON bodies delivered for subscription webhook events. For events, setup, and config vs wire naming, see [Subscription webhooks](/reference/webhook/paylink-subscription/overview). See [Webhook request headers](/reference/webhook/overview#webhook-request-headers) for delivery headers.

<CodeGroup>
  ```json STARTED theme={null}
  {
    "event": "STARTED",
    "subscriptionId": "65dc9f9f1154beaac39976c8",
    "subscriptionState": "NEW",
    "email": "test@example.com",
    "affiliateLink": "somecode",
    "nextChargeUrl": "https://app.hel.io/charge/7e75a4fb-32fd-4aa9-b787-b4ca04289932",
    "chargeToken": "7e75a4fb-32fd-4aa9-b787-b4ca04289932",
    "transaction": "...",
    "transactionObject": { "...": "..." }
  }
  ```

  ```json RENEWED theme={null}
  {
    "event": "RENEWED",
    "subscriptionId": "65dc9f9f1154beaac39976c8",
    "subscriptionState": "RENEWED",
    "email": "test@example.com",
    "nextChargeUrl": "https://app.hel.io/charge/7e75a4fb-32fd-4aa9-b787-b4ca04289932",
    "chargeToken": "7e75a4fb-32fd-4aa9-b787-b4ca04289932",
    "transaction": "...",
    "transactionObject": { "...": "..." }
  }
  ```

  ```json ENDED theme={null}
  {
    "event": "ENDED",
    "subscriptionId": "65dc9f9f1154beaac39976c8",
    "subscriptionState": "EXPIRED",
    "email": "test@example.com",
    "transaction": "...",
    "transactionObject": { "...": "..." }
  }
  ```

  ```json SUBSCRIPTION_PENDING_PAYMENT theme={null}
  {
    "event": "SUBSCRIPTION_PENDING_PAYMENT",
    "subscriptionId": "65dc9f9f1154beaac39976c8",
    "nextChargeUrl": "https://app.hel.io/charge/7e75a4fb-32fd-4aa9-b787-b4ca04289932",
    "chargeToken": "7e75a4fb-32fd-4aa9-b787-b4ca04289932",
    "transaction": "...",
    "transactionObject": { "...": "..." }
  }
  ```
</CodeGroup>

<Info>
  `nextChargeUrl` and `chargeToken` are omitted on `ENDED` events. `email` and `subscriptionState` are omitted on `SUBSCRIPTION_PENDING_PAYMENT`. Each payload includes `transaction` and `transactionObject` with the same shape as [Pay Link payload reference](/reference/webhook/paylink-transaction/payloads).
</Info>