# Email notification events

This topic describes all email notification events.
For information on how to configure email notifications, see [Email notifications](/docs/automations/email-notifications).

To create automations that are not related to email notifications, see [Events](/docs/automations/event-types).

## Core events

### Account password reset requested

Executes when a customer requests a password reset.
Use this event to send a password reset email to the customer.

---

### Account verification requested

Executes when a customer signs-up or requests verification to be resent.
Use this event to send verification or sign-up information to the customer.

---

### AML list possibly matched

Executes when a customer's data matches an entry in the AML list.
Use this event to notify the customer, a third party, or a member of staff about the new customer record.

---

### Application instance disabled

Executes when an application is disabled.
Use this event to notify the customer, a third party, or a member of staff that the application instance is disabled.

---

### Application instance enabled

Executes when a new application instance is enabled.
Use this event to notify the customer, a third party, or a member of staff about the new customer record.

---

### Autodeposit lookup performed

Executes when an autodeposit lookup is performed.
Use this event to notify the customer, a third party, or a member of staff about the result of the autodeposit lookup.

---

### Balance transaction settled

Executes when a balance transaction is settled.
Use this event to notify the customer, a third party, or a member of staff about the settled balance transaction.

---

### Customer created

Executes when a new customer is created.
Use this event to notify the customer, a third party, or a member of staff about the new customer record.

---

### Customer one time password requested

Executes when a customer attempts to log in with One-Time Password (OTP) active.
Use case this event to email the customer their one time password.

---

### Customer updated

Executes when an existing customer record is updated.
Use this event to notify the customer, a third party, or a member of staff about the change to the customer record.

---

### Dispute created

Executes when a dispute, also known as a chargeback, is added to one of your transactions.
Use this event to notify the customer, a third party, or a member of staff about the dispute.

---

### Dispute modified

Executes when a dispute, also known as a chargeback, is modified.
Use this event to notify the customer, a third party, a member of staff, or your fraud agent with the status of the dispute.

---

### Experian check performed

Executes when an [Experian identity check](/docs/app-store/experian-integration) is performed.
Use this event to notify a third party, or a member of staff of the result of the check.

---

### Gateway account downtime ended

Executes when a period of gateway downtime has ended.
Use case this event to notify the customer, a third party, or a member of staff that this gateway is available for use.

---

### Gateway account downtime started

Executes when a period of gateway downtime begins.
Use case event to notify the customer, a third party, or a member of staff that this gateway is temporarily not available for use.

---

### Gateway account limit reached

Executes when a gateway account transaction limit is reached.
A transaction limit may refer to the number of transactions per day, or the amount of a particular transaction.
Use this event to notify the customer that their transaction exceeds the permitted amount.

---

### Gateway account requested

Executes when a customer attempts to make a transaction for the first time.
Use this event to notify the customer, a third party, or a member of staff.

---

### KYC document accepted

Executes when a KYC document is accepted.
Use this event to notify the customer, a third party, or a member of staff that a KYC document has been accepted.

---

### KYC document modified

Executes when a KYC document is modified.
Use this event to notify the customer, a third party, or a member of staff that a KYC document has been modified.

---

### KYC document rejected

Executes when a KYC document is rejected.
Use this event to notify the customer, a third party, or a member of staff that a KYC document has been rejected.

---

### KYC request fulfilled

Executes when a KYC request is fulfilled.
Use this event to notify the customer, a third party, or a member of staff that a KYC request is fulfilled.

---

### Payment card created

Executes when a payment card is created.
Use this event to notify the customer, a third party, or a member of staff.

---

### Risk score changed

Executes when a transaction risk score changes.
Use this event to notify the customer, a third party, or a member of staff.

---

### Transaction amount discrepancy found

Executes when a transaction amount discrepancy is found on reconciliation.
Use this event is to notify the customer of the discrepancy.

---

### Transaction declined

Executes when a transaction is declined.
Use this event to notify the customer that their transaction has been declined.

---

### Transaction discrepancy found

Executes when a paid amount differs from the expected amount.
Use this event to notify the customer, a third party, or a member of staff about the discrepancy.

---

### Transaction process requested

Executes at a point just before the transaction process is initialized.
Use this event to notify the customer, a third party, or a member of staff.

---

### Transaction processed

Executes after a transaction is processed by a payment gateway.
Use this event to notify the customer that their transaction has been processed.

---

## Billing events

### Hard usage limit reached

Executes when a hard usage limit threshold for an item with a metered billing plan is reached.
If a hard usage limit is reached, a customer can no longer use a metered billing service.

Use this event to notify the customer that the hard limit is reached, and to inform them that they must upgrade their plan to continue using the service.

---

### Invoice abandoned

Executes when an invoice is abandoned.
Use this event to notify the customer that their invoice has been abandoned.

---

### Invoice issued

Executes when an invoice is issued.
Use this event to email the invoice to the customer.

---

### Invoice modified

Executes when an invoice is modified.
Use this event to notify the customer that the invoice has been modified.

---

### Invoice paid

Executes when an invoice is paid.
Use this event to email the invoice to the customer.

---

### Invoice partially paid

Executes when an invoice is partially paid.
Use this event to notify the customer that the invoice is partially paid.

---

### Invoice partially refunded

Executes when an invoice is partially refunded.
Use this event to notify the customer that the invoice is partially refunded.

---

### Invoice past due

Executes when an invoice is past due.
Use this event is to remind the customer to pay the invoice.

---

### Invoice past due reminder 15 days

Executes when an unpaid renewal invoice is 15 days past its due date.
The reminder is sent once for that due date, and remains available until 30 days after the due date.
Use this event to email the customer and remind them to pay the invoice.
For more information, see [Invoice past due reminders](/docs/dev-docs/invoices#invoice-past-due-reminders).

---

### Invoice past due reminder 30 days

Executes when an unpaid renewal invoice is 30 days past its due date.
The reminder is sent once for that due date, and remains available until 60 days after the due date.
Use this event to email the customer and remind them to pay the invoice.
For more information, see [Invoice past due reminders](/docs/dev-docs/invoices#invoice-past-due-reminders).

---

### Invoice past due reminder 60 days

Executes when an unpaid renewal invoice is 60 days past its due date.
The reminder is sent once for that due date, and remains available until 90 days after the due date.
Use this event to email the customer and remind them to pay the invoice.
For more information, see [Invoice past due reminders](/docs/dev-docs/invoices#invoice-past-due-reminders).

---

### Invoice past due reminder 90 days

Executes when an unpaid renewal invoice is 90 days past its due date.
The reminder is sent once for that due date, and remains available until 120 days after the due date.
Use this event to email the customer and remind them to pay the invoice.
For more information, see [Invoice past due reminders](/docs/dev-docs/invoices#invoice-past-due-reminders).

---

### Invoice refunded

Executes when an invoice payment is refunded.
Use this event to notify the customer that the invoice has been refunded.

---

### Invoice revenue recognized

Executes when invoice revenue is recognized.
Use this event to notify the customer, a third party, or a member of staff about the recognized revenue.

---

### Invoice tax calculation failed

Executes when an invoice tax calculation fails.
Use this event to notify the customer, a third party, or a member of staff about the failed tax calculation.

---

### Invoice voided

Executes when an invoice is voided.
Use this event to notify the customer that the invoice has been voided.

---

### Order abandoned

Executes when an order is abandoned.
Use this event to notify the customer that their order has been abandoned.

---

### Order change applied

Executes when an order change is applied and the items of the order are replaced.
Use this event to notify the customer that the items of their order have changed.

---

### Order change canceled

Executes when a pending order change is canceled before it is applied.
Use this event to notify the customer that a scheduled change to their order is canceled.

---

### Order change created

Executes when an order change is created.
If the change applies now, the items of the order are replaced immediately.
If the change applies at the next renewal, the change stays pending until the order renews.
Use this event to notify the customer about a change to the items of their order.

---

### Order completed

Executes when an order is completed.
Use this event to notify the customer that their order has been completed.

---

### Order delinquency reached

Executes when the delinquency period of an order is reached.
The delinquency period is the length of time after which an order that contains subscription items is canceled if it is not paid.
For information on how to set the delinquency period, see [Create an order](/docs/data-tables/manage-customer-payments-and-billing#create-an-order).

Use this event to notify the customer by email that an order that contains subscription items is delinquent, and that the order is canceled if the invoice is not paid.

---

### Payment card expiration reminder 14 days

Executes when the active default payment card of a customer is 14 days from expiring.
The reminder is sent only when the customer has an order that contains subscription items, and that order has started and is not churned.
The reminder is sent once for that expiration, and remains available until 7 days before the card expires.
Use this event to email the customer and remind them to update the payment card.
For more information, see [Payment card expiration reminders](/docs/dev-docs/payment-instruments#payment-card-expiration-reminders).

---

### Payment card expiration reminder 7 days

Executes when the active default payment card of a customer is 7 days from expiring.
The reminder is sent only when the customer has an order that contains subscription items, and that order has started and is not churned.
The reminder is sent once for that expiration, and remains available until 1 day before the card expires.
Use this event to email the customer and remind them to update the payment card.
For more information, see [Payment card expiration reminders](/docs/dev-docs/payment-instruments#payment-card-expiration-reminders).

---

### Payment card expiration reminder 1 day

Executes when the active default payment card of a customer is 1 day from expiring.
The reminder is sent only when the customer has an order that contains subscription items, and that order has started and is not churned.
The reminder is sent once for that expiration, and remains available until the card expires.
Use this event to email the customer and remind them to update the payment card.
For more information, see [Payment card expiration reminders](/docs/dev-docs/payment-instruments#payment-card-expiration-reminders).

---

### Payment card expired

Executes when a customer's payment card expires.
Use this event to notify the customer and instruct them to update their billing information.

---

### Payout request readiness job completed

Executes at a recurring interval on websites where the pending period length for payout requests is configured.
This event provides detail on payout requests that have automatically transitioned from the `pending` status to `ready` within the specified timeframe.
Use this event to notify the payments team with counts, merge failures, amounts made ready by currency, and any ready-step failures with reasons.
To set the payout request pending period for a website, see [Edit payout request settings](/docs/settings/organizations-and-websites#edit-payout-request-settings).

---

### Quote accepted

Executes when a quote is accepted.
Use this event to notify the customer, a third party, or a member of staff that the quote has been accepted.

---

### Quote canceled

Executes when a quote is canceled.
Use this event to notify the customer, a third party, or a member of staff that the quote has been canceled.

---

### Quote created

Executes when a quote is created.
Use this event to notify the customer, a third party, or a member of staff about the creation of the quote.

---

### Quote expired

Executes when a quote expires.
Use this event to notify the customer, a third party, or a member of staff that the quote has expired.

---

### Quote issued

Executes when a quote is issued.
Use this event to notify the customer, a third party, or a member of staff that the quote has been issued.

---

### Quote recalled

Executes when a quote is recalled.
Use this event to notify the customer, a third party, or a member of staff that the quote has been recalled.

---

### Quote rejected

Executes when a quote is rejected.
Use this event to notify the customer, a third party, or a member of staff that the quote has been rejected.

---

### Quote updated

Executes when a quote is updated.
Use this event to notify the customer, a third party, or a member of staff that the quote has been updated.

---

### Renewal invoice issued

Executes when a renewal invoice is issued.
Use case event to email the invoice to the customer.

---

### Renewal invoice payment canceled

Executes when a renewal invoice payment is canceled.
Use this event to notify the customer that renewal payment has been canceled.

---

### Renewal invoice payment declined

Executes when a renewal invoice payment is declined.
A renewal invoice is a recurring invoice for a plan or product which is charged automatically.
Use this event to inform the customer that their payment was declined.

---

### Soft usage limit reached

Executes when a soft usage limit threshold for an item with a metered billing plan is reached.
Soft usage limits are used to notify customers that their usage is near the hard limit of their metered billing plan, so that they can upgrade their plan before the [hard limit is reached](#hard-usage-limit-reached).

Use this event to notify customers that their usage is near the hard limit of their metered billing plan, and that they may soon need to upgrade their plan to continue using the service.

---

### Order activated

Executes when an order that contains subscription items is activated.
Use this event is to send a confirmation email to the customer.

---

### Order canceled

Executes when an order that contains subscription items is canceled.
Use this event to notify third-party services, and request to disallow access for the customer.

---

### Order churned

Executes when an order that contains subscription items is churned.
Use this event to notify the customer, a third party, or a member of staff about the churned subscription.

---

### Order created

Executes when a customer signs up to a subscription service.
At this point, the order that contains subscription items has the [pending status](/docs/dev-docs/subscriptions#subscription-status) and is not active.
The order that contains subscription items becomes active when an invoice is paid, or when a payment instrument is verified for free trial.

Use this event to notify the customer, a third party, or a member of staff about the new subscription.

---

### Order downgraded

Executes when an order that contains subscription items is downgraded.
Use this event to notify the customer, a third party, or a member of staff about the downgrade of the subscription.

---

### Subscription items changed

Executes when subscription items on an order that contains subscription items are changed.
Use this event to notify the customer, a third party, or a member of staff about the change to the subscription.

---

### Subscription quantity filled limit reached

Executes when a subscription item that uses a metered billing plan on an order that contains subscription items reaches its quantity filled limit.
Use this event to notify the customer, a third party, or a member of staff that the limit has been reached.

---

### Order paused

Executes when an order that contains subscription items is paused.
Use this event to notify the customer, a third party, or a member of staff about the paused subscription.

---

### Order reactivated

Executes when an order that contains subscription items is reactivated.
Use this event to notify the customer, a third party, or a member of staff about the reactivation of the subscription.

---

### Subscription ended

Executes when an order that contains subscription items has ended.
Use this event to notify the customer, a third party, or a member of staff about the end of the subscription.

---

### Order renewed

Executes when an order that contains subscription items is renewed.
Use this event to notify the customer about the renewed subscription.

---

### Order resumed after a pause

Executes when an order that contains subscription items is resumed.
Use this event to notify the customer, a third party, or a member of staff about the resumed subscription.

---

### Order trial converted

Executes when the first invoice is paid and the trial has ended.
Use this event to notify the customer, a third party, or a member of staff about the conversion of the trial subscription to a paid subscription.

---

### Subscription trial end reminder

Executes when the trial for an order that contains subscription items is three days from ending.
Use this event to email the customer and remind them of the trial end date.

---

### Order trial ended

Executes when the trial ends for an order that contains subscription items.
Use this event to notify the customer, a third party, or a member of staff about the end of the trial subscription.

---

### Order upgraded

Executes when an order that contains subscription items is upgraded.
Use this event to notify the customer, a third party, or a member of staff about the upgrade of the subscription.

---

### Trial usage limit reached

Executes when a trial usage limit is reached for a subscription item on an order.
Use this event to notify the customer, a third party, or a member of staff that the limit has been reached.
