# Subscription Webhooks

Subscription webhooks notify you about events related to subscriptions.

> **Note:** The sample payloads on this page are pretty-printed. The body Glomo sends is the RFC 8785 canonical form of the same object, and the `X-Glomopay-Signature` header is computed over those bytes. See [Webhook Authentication & Security](/platform/webhooks#webhook-authentication--security).


| Event Type | Description |
|  --- | --- |
|  active  | The subscription is active. |
|  authorized  | The subscription has been authorized and recurring payments will start on the scheduled date |
|  cancelled  | The subscription has been cancelled and no further billing will occur. |
|  completed  | The subscription has run its full billing cycle and is complete. |
|  expired  | The subscription has expired and is no longer valid. |
|  halted  | The subscription has been halted and is pending manual reactivation. |
|  paused  | The subscription has been paused. No further payments will be charged until resumed. |
|  updated  | The subscription has been updated. |


## Sample Payload

```Sample
{
    "entity_type": "subscription",
    "event_type": "completed",
    "data": {
        "id": "sub_5JU9yv0lGSUP",
        "customer_id": "cust_5JU9yv0lGSUP",
        "product_name": "ShieldGuard Insurance",
        "product_description": "Flexible, monthly insurance for belongings, travel, and digital assets, easy to manage",
        "plan_name": "ShieldGuard Lite",
        "plan_description": "Simple, monthly insurance plan that covers your basic belongings and key digital assets",
        "reference_number": "R0001",
        "status": "active",
        "amount": 1000,
        "currency": "USD",
        "interval_type": "month",
        "interval_count": 1,
        "billing_cycles": 12,
        "start_date": "2025-01-01",
        "end_date": "2025-12-01",
        "expires_at": "2025-01-07",
        "next_payment_date": "2025-02-01",
        "subscription_link_url": "https://glomopay.com/subscription/sub_5JU9yv0lGSUP",
        "cancelled_at": "2025-01-15",
        "notes": {
            "key1": "value1",
            "key2": "value2"
        }
    }
}
```