What Are Notification Events?
Notification Events determine the specific conditions or triggers that activate a notification. These events are tied to key points in the form submission and entry processing lifecycle. When an event occurs, the associated notification is triggered.
Where Can I Find Notifications Events?
When you create a Notification, you will find an Event drop-down with all the events enabled in your installation. Notification events can be added by add-ons or custom code, so your event options may differ from those shown here. Refer to this article for more information about creating Notifications.
Gravity Forms Notifications Events
Several notification events are available within Gravity Forms and additional add-ons. In this article, we will outline the notification events that are available to you.
| Event | Description |
|---|---|
| Form is submitted | The Form is submitted notification event does exactly what it says – sends a notification when a form is submitted. This is the default notification sent if you do not have any selections available within your installed add-ons. |
| Form is saved | When using the Save and Continue functionality on your form, this event becomes available. By using this event type, a notification will be sent any time a form is saved to be continued later. |
| Save and continue email is requested | This notification is sent each time an email containing the save and continue link is requested. Upon enabling Save and Continue within your form settings, a notification for this event is automatically created. |
Payment Add-On Events
Payment Completed
Available in:
- PayPal Checkout Add-On
- PayPal Standard Add-On
- PayPal Payments Pro Add-On
- Square Add-On
- Stripe Add-On
- Authorize.Net Add-On
- Mollie Add-On
The Payment Completed notification event will send the notification when a product and services payment has successfully been completed.
This is not to be confused with the Subscription Created event which will occur when a new subscription is created.
Payment Refunded
Available in:
- PayPal Checkout Add-On
- PayPal Standard Add-On
- Square Add-On
- Stripe Add-On
- Mollie Add-On
When a payment is refunded the Payment Refunded event will trigger a notification.
Payment Failed
Available in:
- PayPal Checkout Add-On
- PayPal Standard Add-On
- Square Add-On
- Stripe Add-On
- Mollie Add-On
If a payment fails after the entry creation, and the payment gateway reports the status change to your site, any notifications configured for the Payment Failed event will be triggered.
Payment Pending
Available in:
- PayPal Checkout Add-On
- PayPal Standard Add-On
If a payment is pending, a notification will be sent to notifications with the Payment Pending event type.
Remember that this notification only fires if you have your PayPal IPN correctly configured.
Authorization Voided
Available in:
- PayPal Checkout Add-On
- PayPal Standard Add-On
When a prior authorization has been voided, a notification will be sent to the notification methods with the Authorization Voided event type.
Subscription Created
Available in:
- PayPal Checkout Add-On
- PayPal Standard Add-On
- PayPal Payments Pro Add-On
- Stripe Add-On
- Authorize.Net Add-On
If you have a subscription configured, use the Subscription Created event type to send notifications when a new subscription is created.
Subscription Canceled
Available in:
- PayPal Checkout Add-On
- PayPal Standard Add-On
- PayPal Payments Pro Add-On
- Square Add-On
- Stripe Add-On
- Authorize.Net Add-On
If a subscription is canceled, notifications with the Subscription Canceled event type will be sent.
Subscription Expired
Available in:
- PayPal Checkout Add-On
- PayPal Standard Add-On
- PayPal Payments Pro Add-On
- Stripe Add-On
- Authorize.Net Add-On
If a subscription becomes expired, a notification will fire to any notifications with the Subscription Expired event type.
Subscription Payment Added
Available in:
- PayPal Checkout Add-On
- PayPal Standard Add-On
- PayPal Payments Pro Add-On
- Stripe Add-On
- Authorize.Net Add-On
Each time a payment is made within a subscription, the Subscription Payment Added notification event will be triggered.
Subscription Payment Failed
Available in:
- PayPal Checkout Add-On
- PayPal Standard Add-On
- Stripe Add-On
- Authorize.Net Add-On
If an existing subscription payment fails, the Subscription Payment Failed notification will be sent.
Help Scout Add-On
| Event | Description |
|---|---|
| Conversation is created | The Help Scout Conversation Created notification event will send a notification when a Help Scout conversation is created. |
Partial Entries Add-On
| Event | Description |
|---|---|
| Saved | The Saved notification event will send a notification when a partial entry is saved for the first time. See note 1. |
| Updated | The Updated event will send the notification when an update request for an existing partial entry is received. See note 2. |
Note
- Note that this is different from the Form is submitted event, or the Updated event in which the notification will fire for every partial entry update request.
- Bear in mind that many update requests can happen until the user submits the form or leaves the page, and they are fired by the Heartbeat API even if there’s not any new data in the form fields, therefore using this event can lead to multiple emails being sent.
User Registration Add-On
The following are the various notification events that are available when the User Registation add-on is being used.
| Event | Description |
|---|---|
| Site is created | The Site is created event will send a notification when a new site is created within a WordPress multisite installation. |
| User is pending activation | When a user is pending activation, the User is pending activation event can be used to send notifications when a user is added to the activation queue. |
| User is activated | The User is activated event is used to send notifications when a new user is activated on the site. |
| User is registered | Sends the notification when a user is registered on the site with the User Registration Add-On. |
| User is updated | Sends the notification when the user is updated with an “Update User” User Registration Add-On feed. |
| User pending activation deleted | Sends the notification when the pending activation is deleted without being activated. Available with User Registration v4.4.4 and greater. |
Creating Custom Notification Events
In addition to the default notification events, developers can create their own custom notification events using the gform_notification_events filter. Refer to this article for more information about using the filter.