Developer notifications overview

Notifications can be delayed, and you can use Liquid, GraphQL, and trigger conditions to decide if a notification should be sent. For example, they are a mechanism to welcome new users, follow up after they've added their first item, or reach out to them if they have been inactive for a while.

Supported notification types

Currently, we support three types of notifications:

• Email
• SMS
• API call

Notifications directory

Each notification type has its own folder. Put the folders in , or in or if the code belongs to a module:

• : contains all Email Notifications
• : contains all SMS Notifications
• : contains all API Call Notifications

Configuration

Each configuration can accept different properties, but some of the main concepts are common:

Property	Description	Default	Example
to	Depending on the alert type, it is either: an email address of the recipient (or comma-delimited list of emails) mobile number of the recipient endpoint for the API call Accepts Liquid.	n/a
delay	The number of minutes the notification should be delayed. You could use Liquid to calculate the number. For example, you could schedule an email to be sent the next day at 10 am time:	0	2
enabled	Boolean; defines whether an alert should be invoked. If false, it will be ignored.	true	false
locale	Liquid code which evaluates to the desired language code, which should be used for translations and date format.
trigger_condition	Liquid condition to control whether a notification should be sent. The only value that allows notification to be delivered is . If you skip it, the notification will be sent (unless enabled is false). Upon a notification event, the is checked after the delay has been executed.	true	- this code will trigger the notification only if the value of is equal to 'some_value'.

Accessing form data from the notification

Wherever you have access to Liquid inside the notification, you can access data submitted in the form which triggered the notification using the variable. Its structure mirrors the associated form's property. When in doubt, you can always use it to visualize the structure. If you want to access properties not included in the variable, you should use a GraphQL query to fetch them. You can access the of the resource associated with the submitted form via .

Related Topics

Please visit the following topics to learn more about Notifications:

• Creating an Email Notification
• Creating an SMS Notification
• Creating an API Call Notification
• Form Configuration Options