Overview
The OpenEMM Trigger node is designed to integrate with the OpenEMM Email Marketing Management (EMM) system by listening for specific webhook events. It enables workflows in n8n to react automatically when certain email-related events occur, such as when a recipient clicks a link, an email bounces, or a mailing is sent.
This node is beneficial in scenarios where you want to automate follow-up actions based on recipient interactions or status changes in your email campaigns. For example:
- Automatically updating contact records when a recipient unsubscribes.
- Triggering notifications or analytics updates when emails are delivered or opened.
- Reacting to bounced emails to clean mailing lists.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method used to authenticate with the OpenEMM API. Options: API Token or Basic authentication. |
| Events | The specific OpenEMM webhook events to listen for. Multiple can be selected. Options include: - Link Clicked: Triggered when a recipient clicks a link in an email. - Mail Bounced: Triggered on permanent delivery failure. - Mail Delivered: Triggered when mail is successfully delivered. - Mail Opened: Triggered when recipient opens the mail. - Mailing Sent: Triggered when mailing has been sent to all recipients. - Mailing Unsubscribed: Triggered when recipient unsubscribes. - Profile Field Changed: Triggered when recipient's profile field changes. - Test Mail Delivered: Triggered when a test mail is delivered successfully. |
Output
The node outputs JSON data representing the webhook payload received from OpenEMM. This JSON contains details about the event that triggered the webhook, including information relevant to the selected event type (e.g., recipient info, mailing details, event timestamps).
The output is structured as an array of JSON objects, each corresponding to one webhook event received.
The node does not output binary data.
Dependencies
- Requires an active OpenEMM instance accessible via its API endpoint (
https://emm.agnitas.de). - Requires user-provided credentials for authentication, either an API token or basic authentication credentials.
- The node uses a webhook URL configured in OpenEMM to receive event notifications.
Troubleshooting
- Webhook Not Triggering: Ensure that the webhook URL provided by n8n is correctly registered in OpenEMM and that the selected events match those configured in OpenEMM.
- Authentication Errors: Verify that the correct authentication method is selected and that credentials are valid.
- Empty Payloads: Confirm that OpenEMM is sending data for the selected events and that the webhook is receiving POST requests.
- Unsupported Events: If no events are selected, the node will not trigger; always select at least one event.