> For the complete documentation index, see [llms.txt](https://help.fungies.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.fungies.io/for-saas-developers/types-of-webhooks/subscription-updated.md).

# Subscription Updated

Subscription Updates are fired when any modification is made to an active subscription, such as a plan upgrade, downgrade, or billing information update. This webhook ensures subscription data is always current and can be used to adjust billing details, send confirmation messages, or trigger relevant workflows based on the updated subscription status.

<figure><img src="/files/4cAdcMXHF4jYqblQwpUv" alt="" width="563"><figcaption></figcaption></figure>

### Example of Request Payload Object (subscription\_updated)

```
{
  "id": "e15036d5-d1d1-4ff9-951c-138e63c09353",
  "type": "subscription_updated",
  "testMode": true,
  "data": {
    "user": {
      "id": "31313125-3dcb-47dc-a09a-1d7f33e45460",
      "email": "test@fungies.io",
      "object": "user",
      "username": null,
      "internalId": null
    },
    "items": [],
    "lastPayment": {
      "id": "1d9b5f04-7bcb-4f53-8639-a70d8c0d8695",
      "fee": 0,
      "tax": 0,
      "type": "subscription_initial",
      "value": 0,
      "number": "uXXdy1A7BPdX8xDp",
      "object": "payment",
      "status": "PAID",
      "userId": "31313125-3dcb-47dc-a09a-1d7f33e45460",
      "orderId": "1d9b5f04-7bcb-4f53-8639-a70d8c0d8695",
      "currency": "USD",
      "createdAt": 1732373872603,
      "orderNumber": "uXXdy1A7BPdX8xDp",
      "currencyDecimals": 2
    },
    "subscription": {
      "id": "uXXdy1A7BPdX8xDp",
      "object": "subscription",
      "userId": "31313125-3dcb-47dc-a09a-1d7f33e45460",
      "orderId": "1d9b5f04-7bcb-4f53-8639-a70d8c0d8695",
      "createdAt": 1731938713000,
      "canceledAt": null,
      "orderNumber": "uXXdy1A7BPdX8xDp",
      "lastPaymentId": "1d9b5f04-7bcb-4f53-8639-a70d8c0d8695",
      "lastPaymentNumber": "uXXdy1A7BPdX8xDp",
      "currentIntervalEnd": 1734530713000,
      "cancelAtIntervalEnd": false,
      "currentIntervalStart": 1731938713000
    }
  },
  "idempotencyKey": "e15036d5-d1d1-4ff9-951c-138e63c09353"
}
```