# Subscriptions webhooks (/subscriptions/webhooks)



A webhook is an HTTP callback that receives notification messages for events. See [configure webhooks](/api/rest/webhooks/) for more details.

PayPal APIs use webhooks for event notification. Most subscription-related actions trigger webhook events:

| Webhook                                 | Trigger                                   | Related method                                                                          |
| --------------------------------------- | ----------------------------------------- | --------------------------------------------------------------------------------------- |
| `CATALOG.PRODUCT.CREATED`               | A product is created.                     | [Create product](/api/catalog-products/v1/products-create)                              |
| `CATALOG.PRODUCT.UPDATED`               | A product is updated.                     | [Update product](/api/catalog-products/v1/products-patch)                               |
| `PAYMENT.SALE.COMPLETED`                | A payment is made on a subscription.      |                                                                                         |
| `PAYMENT.SALE.REFUNDED`                 | A merchant refunds a sale.                |                                                                                         |
| `PAYMENT.SALE.REVERSED`                 | A payment is reversed on a subscription.  |                                                                                         |
| `BILLING.PLAN.CREATED`                  | A billing plan is created.                | [Create plan](/api/subscriptions/v1/plans-create)                                       |
| `BILLING.PLAN.UPDATED`                  | A billing plan is updated.                | [Update plan](/api/subscriptions/v1/plans-patch)                                        |
| `BILLING.PLAN.ACTIVATED`                | A billing plan is activated.              | [Activate plan](/api/subscriptions/v1/plans-activate)                                   |
| `BILLING.PLAN.PRICING-CHANGE.ACTIVATED` | A price change for the plan is activated. | [Update pricing](/api/subscriptions/v1#plans_update-pricing-schemes)                    |
| `BILLING.PLAN.DEACTIVATED`              | A billing plan is deactivated.            | [Deactivate plan](/api/subscriptions/v1/plans-deactivate)                               |
| `BILLING.SUBSCRIPTION.CREATED`          | A subscription is created.                | [Create subscription](/api/subscriptions/v1/subscriptions-create)                       |
| `BILLING.SUBSCRIPTION.ACTIVATED`        | A subscription is activated.              | [Activate subscription](/api/subscriptions/v1/subscriptions-activate)                   |
| `BILLING.SUBSCRIPTION.UPDATED`          | A subscription is updated.                | [Update subscription](/api/subscriptions/v1/subscriptions-patch)                        |
| `BILLING.SUBSCRIPTION.EXPIRED`          | A subscription expires.                   | [Show subscription details](/api/subscriptions/v1/subscriptions-get)                    |
| `BILLING.SUBSCRIPTION.CANCELLED`        | A subscription is cancelled.              | [Cancel subscription](/api/subscriptions/v1/subscriptions-cancel)                       |
| `BILLING.SUBSCRIPTION.SUSPENDED`        | A subscription is suspended.              | [Suspend subscription](/api/subscriptions/v1/subscriptions-suspend)                     |
| `BILLING.SUBSCRIPTION.PAYMENT.FAILED`   | Payment failed on subscription.           | [Subscription failed payment details](/api/subscriptions/v1#subscriptions-get-response) |