subscription.updated

Sent when a subscription is updated. This event fires for all changes to the subscription, including renewals.

If you want more specific events, you can listen to subscription.active, subscription.canceled, and subscription.revoked.

To listen specifically for renewals, you can listen to order.created events and check the billing_reason field.

Discord & Slack support: On cancellation and revocation. Renewals are skipped.

{
  "type": "subscription.updated",
  "data": {
    "created_at": "2024-12-22T00:00:00.000Z",
    "modified_at": "2024-12-22T00:00:00.000Z",
    "id": "00000000-0000-0000-0000-000000000000",
    "amount": 0,
    "currency": "string",
    "recurring_interval": "month",
    "status": "incomplete",
    "current_period_start": "2024-12-22T00:00:00.000Z",
    "current_period_end": "2024-12-22T00:00:00.000Z",
    "cancel_at_period_end": false,
    "started_at": "2024-12-22T00:00:00.000Z",
    "ended_at": "2024-12-22T00:00:00.000Z",
    "customer_id": "00000000-0000-0000-0000-000000000000",
    "product_id": "00000000-0000-0000-0000-000000000000",
    "price_id": "00000000-0000-0000-0000-000000000000",
    "discount_id": "00000000-0000-0000-0000-000000000000",
    "checkout_id": "00000000-0000-0000-0000-000000000000",
    "metadata": {},
    "custom_field_data": {},
    "customer": {
      "created_at": "2024-12-22T00:00:00.000Z",
      "modified_at": "2024-12-22T00:00:00.000Z",
      "id": "00000000-0000-0000-0000-000000000000",
      "metadata": {},
      "email": "string",
      "email_verified": false,
      "name": "string",
      "billing_address": {
        "line1": "string",
        "line2": "string",
        "postal_code": "string",
        "city": "string",
        "state": "string",
        "country": "string"
      },
      "tax_id": [
        "string",
        "ad_nrt"
      ],
      "organization_id": "00000000-0000-0000-0000-000000000000",
      "avatar_url": "string"
    },
    "user_id": "00000000-0000-0000-0000-000000000000",
    "user": {
      "id": "00000000-0000-0000-0000-000000000000",
      "email": "string",
      "public_name": "string",
      "avatar_url": "string",
      "github_username": "string"
    },
    "product": {
      "created_at": "2024-12-22T00:00:00.000Z",
      "modified_at": "2024-12-22T00:00:00.000Z",
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "string",
      "description": "string",
      "is_recurring": false,
      "is_archived": false,
      "organization_id": "00000000-0000-0000-0000-000000000000",
      "metadata": {},
      "prices": [
        {
          "created_at": "2024-12-22T00:00:00.000Z",
          "modified_at": "2024-12-22T00:00:00.000Z",
          "id": "00000000-0000-0000-0000-000000000000",
          "amount_type": "fixed",
          "is_archived": false,
          "product_id": "00000000-0000-0000-0000-000000000000",
          "price_currency": "string",
          "price_amount": 0,
          "type": "recurring",
          "recurring_interval": "month"
        }
      ],
      "benefits": [
        {
          "created_at": "2024-12-22T00:00:00.000Z",
          "modified_at": "2024-12-22T00:00:00.000Z",
          "id": "00000000-0000-0000-0000-000000000000",
          "type": "ads",
          "description": "string",
          "selectable": false,
          "deletable": false,
          "organization_id": "00000000-0000-0000-0000-000000000000",
          "properties": {
            "image_height": 0,
            "image_width": 0
          }
        }
      ],
      "medias": [
        {
          "id": "00000000-0000-0000-0000-000000000000",
          "organization_id": "00000000-0000-0000-0000-000000000000",
          "name": "string",
          "path": "string",
          "mime_type": "string",
          "size": 0,
          "storage_version": "string",
          "checksum_etag": "string",
          "checksum_sha256_base64": "string",
          "checksum_sha256_hex": "string",
          "last_modified_at": "2024-12-22T00:00:00.000Z",
          "version": "string",
          "service": "product_media",
          "is_uploaded": false,
          "created_at": "2024-12-22T00:00:00.000Z",
          "size_readable": "string",
          "public_url": "string"
        }
      ],
      "attached_custom_fields": [
        {
          "custom_field_id": "00000000-0000-0000-0000-000000000000",
          "custom_field": {
            "created_at": "2024-12-22T00:00:00.000Z",
            "modified_at": "2024-12-22T00:00:00.000Z",
            "id": "00000000-0000-0000-0000-000000000000",
            "metadata": {},
            "type": "text",
            "slug": "string",
            "name": "string",
            "organization_id": "00000000-0000-0000-0000-000000000000",
            "properties": {
              "form_label": "string",
              "form_help_text": "string",
              "form_placeholder": "string",
              "textarea": false,
              "min_length": 0,
              "max_length": 0
            }
          },
          "order": 0,
          "required": false
        }
      ]
    },
    "price": {
      "created_at": "2024-12-22T00:00:00.000Z",
      "modified_at": "2024-12-22T00:00:00.000Z",
      "id": "00000000-0000-0000-0000-000000000000",
      "amount_type": "fixed",
      "is_archived": false,
      "product_id": "00000000-0000-0000-0000-000000000000",
      "price_currency": "string",
      "price_amount": 0,
      "type": "recurring",
      "recurring_interval": "month"
    },
    "discount": {
      "duration": "once",
      "type": "fixed",
      "amount": 0,
      "currency": "string",
      "created_at": "2024-12-22T00:00:00.000Z",
      "modified_at": "2024-12-22T00:00:00.000Z",
      "id": "00000000-0000-0000-0000-000000000000",
      "metadata": {},
      "name": "string",
      "code": "string",
      "starts_at": "2024-12-22T00:00:00.000Z",
      "ends_at": "2024-12-22T00:00:00.000Z",
      "max_redemptions": 0,
      "redemptions_count": 0,
      "organization_id": "00000000-0000-0000-0000-000000000000"
    }
  }
}