> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# Subscribe to notifications for discounts

Subscribe to notifications for discount events to get notified when discounts are created and updated.

---

## What's new?

We added two new events that you can subscribe to:

- [`discount.created`](https://developer.paddle.com/webhooks/discounts/discount-created.md)  
   Occurs when a discount is created.
- [`discount.updated`](https://developer.paddle.com/webhooks/discounts/discount-updated.md)  
   Occurs when a discount is updated.

## How it works

Discounts let you reduce the amount that a customer has to pay by a percentage (e.g. -10%) or fixed amount (e.g. -$10) for an item or transaction.

Paddle now creates events for discounts, meaning you get notifications when a discount is created or updated.

Notifications include the complete discount entity, except `discount.times_used`. This field changes frequently, so isn't included in payloads.

## Examples

```json {% title="discount.created" %}
{
  "event_id": "evt_01hv6scz1kqjp8wx6ft1mc3kd2",
  "event_type": "discount.created",
  "occurred_at": "2024-04-11T14:36:15.283806Z",
  "notification_id": "ntf_01hv6scz45nrn82tmkw4ywb71k",
  "data": {
    "id": "dsc_01hv6scyf7qdnzcdq01t2y8dx4",
    "description": "All orders (10% off)",
    "code": "BF10OFF",
    "type": "percentage",
    "amount": "10",
    "currency_code": "USD",
    "mode": "standard",
    "status": "active",
    "discount_group_id": "dsg_01js2gqehzccfkywgx1jk2mtsp",
    "recur": true,
    "maximum_recurring_intervals": 3,
    "usage_limit": null,
    "restrict_to": [],
    "enabled_for_checkout": true,
    "expires_at": "2024-12-03T00:00:00Z",
    "created_at": "2024-04-11T14:36:14.695Z",
    "updated_at": "2024-04-11T14:36:14.695Z",
    "custom_data": null,
    "import_meta": null
  }
}
```

## Next steps

This change is available in version `1` of the Paddle API.

It's a non-breaking change, meaning it doesn't impact existing integrations.

You can [create a notification destination](https://developer.paddle.com/webhooks/notification-destinations.md) for the new discount events by going to **Paddle > Developer tools > Notifications**, or by using the [create a notification destination operation](https://developer.paddle.com/api-reference/notification-settings/create-notification-setting.md) in the Paddle API.
## Summary of changes

| Name | Type | Change | Entity | Description |
| --- | --- | --- | --- | --- |
| `discount.created` | Webhook | added | Discounts |  |
| `discount.updated` | Webhook | added | Discounts |  |