---
title: "subscription.updated"
method: POST
path: "subscription.updated"
---

# subscription.updated

`POST subscription.updated` (webhook)

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`, `subscription.past_due`, and `subscription.revoked`.

To listen specifically for renewals, listen to `subscription.cycled`.

**Discord & Slack support:** On cancellation, past due, and revocation. Renewals are skipped.

## Payload

- WebhookSubscriptionUpdatedPayload — 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`, `subscription.past_due`, and `subscription.revoked`. To listen specifically for renewals, listen to `subscription.cycled`. **Discord & Slack support:** On cancellation, past due, and revocation. Renewals are skipped.
  - `type` 'subscription.updated', required
  - `timestamp` string, date-time, required
  - `data` Subscription, required — unresolved $ref

## Acknowledgement `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/polar/apis/polar-api.md) · [All operations](https://skmtc.net/polar/apis/polar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polar/polar-api/revisions/77e4ef94fcc3/schema)