# Event Types

> For the complete machine-readable documentation index, see [llms.txt](https://apidocs.chargebee.com/llms.txt).


This is a list of the event types we currently support. We will continue to add more events moving forward. All events follow a uniform pattern - `<resource>_<event_name>`. The resources that will be present in the event content are provided beneath each event type's description.

**Note:** If _consolidated invoicing_ is enabled, the attributes _invoice.subscription\_id_ and _credit\_note.subscription\_id_ should **not** be used (as it will not be present if the invoice / credit note has lines from multiple subscriptions). Instead to know the related subscriptions, their line\_items' _subscription\_id_ attribute should be referred.

## List of Events

### card_added

Triggered when a card is added for a customer.

### card_deleted

Triggered when a card is deleted for a customer.

### card_expired

Triggered when the card for a customer has expired.

### card_expiring

Triggered when the customer's credit card is expiring soon. Triggered 30 days before the expiry date.

### card_updated

Triggered when the card is updated for a customer.

### customer_changed

Triggered when a customer is changed.

### customer_created

Triggered when a customer is created.

### customer_deleted

Triggered when a customer is deleted.

### invoice_created

Event triggered (in the case of metered billing) when a "Pending" invoice is created that has usage related charges or line items to be added, before being closed. This is triggered only when the "Notify for Pending Invoices" option is enabled.

### invoice_deleted

Event triggered when an invoice is deleted.

### invoice_generated

Event triggered when a new invoice is created except when created with status as pending. For pending invoices, this event is triggered when the invoice is closed.

### invoice_updated

Triggered when changes are made to a finalized invoice, including voiding, deletion, invoice address updates, status changes, and payment changes such as applying or removing a payment, applying or removing a credit, and credit note creation. pending\_invoice\_updated is triggered for changes specific to pending invoices; invoice\_updated covers all other invoice changes.

### payment_failed

Triggered when the payment collection fails.

### payment_initiated

Triggered when a payment is initiated via direct debit.

### payment_refunded

Triggered when a payment refund is made.

### payment_succeeded

Triggered when the payment is successfully collected.

### refund_initiated

Triggered when a refund is initiated via direct debit.

### subscription_activated

Triggered after the subscription has been moved from "Trial" to "Active" state.

### subscription_cancellation_scheduled

Triggered when subscription is scheduled to cancel at end of current term.

### subscription_cancelled

Triggered when the subscription is cancelled. If it is cancelled due to non payment or because the card details are not present, the subscription will have the possible reason as 'cancel\_reason'.

### subscription_cancelling

Triggered 6 days prior to the scheduled cancellation date.

### subscription_changed

Triggered when the subscription's recurring items are changed.

### subscription_created

Triggered when a new subscription is created.

### subscription_deleted

Triggered when a subscription is deleted.

### subscription_reactivated

Triggered when the subscription is moved from `cancelled` `status` to `active` or `in_trial`.

### subscription_renewal_reminder

Triggered 3 days before each subscription's renewal.

### subscription_renewed

Triggered when the subscription is renewed from the current term.

### subscription_scheduled_cancellation_removed

Triggered when scheduled cancellation is removed for the subscription.

### subscription_shipping_address_updated

Triggered when shipping address is added or updated for a subscription.

### subscription_started

Triggered when a 'future' subscription gets started.

### subscription_trial_ending

Triggered 6 days prior to the trial period's end date.

### subscription_trial_extended

Trial Extension

### transaction_created

Triggered when a transaction is recorded.

### transaction_deleted

Triggered when a transaction is deleted.

### transaction_updated

Triggered when a transaction is updated. E.g. (1) When a transaction is removed, (2) or when an excess payment is applied on an invoice, (3) or when amount\_capturable gets updated.

