Notification Event Widget
Learn how to configure the Notification Event widget in workflows by selecting notification events, mapping destination fields, configuring template placeholders, and passing additional data.
The Notification Event widget is used to trigger notification workflows configured in the platform. Users can select any notification event that has already been created, such as email campaigns, transactional alerts, or messaging workflows.
For example, you can use the bulk-emails notification event to send bulk email communications by mapping recipient information and template placeholders dynamically from the workflow payload.
Steps to configure Notification Event
Drag and drop the Notification Event widget into the workflow and connect it to the previous step.
Select the required notification event from the dropdown. In this example, the selected notification event is bulk-emails.
Configure the Destination section by mapping the recipient details. You can map either:
- Distinct ID - Unique identifier of the user profile stored in the platform.
- Email - Email address of the recipient receiving the notification.
Example:
{
"email": "$input.user.email"
}Configure the Data section.
The fields displayed in this section are placeholders configured in the selected notification template. These placeholders can be mapped dynamically using workflow payload data.
For the bulk-emails event, the following placeholders are available:
| Field | Description |
|---|---|
| CC | Email addresses added as carbon copy recipients. |
| bcc | Email addresses added as blind carbon copy recipients. |
| from_name | Sender name displayed in the email. |
| from_email | Sender email address used to send the email. |
| name | Dynamic placeholder typically used for recipient personalization. |
Example Mapping:
| Placeholder | Example Value |
|---|---|
| from_name | Support Team |
| from_email | support@example.com |
| name | $input.user.name |
| CC | manager@example.com |
| bcc | audit@example.com |
Configure the Additional Data section to add extra placeholders that are not already present in the template.
You can:
- Add a Placeholder name
- Map a corresponding Placeholder value
- Use the Add Another (+) option to add multiple placeholder mappings
Example:
| Placeholder name | Placeholder value |
|---|---|
| campaign_id | $input.campaign.id |
| region | $input.user.region |
The fields displayed under the Data section depend on the placeholders configured in the selected notification event template. Different notification events may display different fields.