OpenEMMInstall

Overview

This node integrates with an Email Marketing Management (EMM) system to manage recipients. Specifically, the Recipient - Create operation allows users to add new recipients to the EMM database. It supports setting the recipient's email, profile fields, and optionally managing their subscription status to mailing lists.

Common scenarios where this node is beneficial include:

• Adding new contacts collected from forms or CRM systems into your email marketing platform.
• Automating subscriber onboarding workflows by creating recipients and optionally subscribing them to specific mailing lists.
• Enriching recipient profiles with custom fields during creation for personalized marketing campaigns.

Example use case: After a user signs up on a website, this node can create a new recipient in the EMM system with their email and additional profile data, and subscribe them to a welcome newsletter mailing list.

Properties

Name	Meaning
Authentication	Method of authentication; currently only "Basic" authentication is supported.
Email	The email address of the recipient to be created. This is required.
Manage Subscription	Boolean flag indicating whether to manage the recipient's subscription binding to a mailing list.
Mailing List Name or ID	If "Manage Subscription" is enabled, select the mailing list to which the recipient should be subscribed. You can choose from a loaded list or specify an ID via expression.
Status	Subscription status of the recipient when managing subscription. Options are: Active, Bounced, Opt-Out By Admin, Opt-Out By Recipient, Waiting For Double Opt-In Confirmation, On Blocklist, Temporary Suspended. Default is Active.
Recipient Fields	A collection of custom profile fields for the recipient. Each field requires selecting a field name (loaded dynamically) and providing its value. These fields enrich the recipient's profile beyond just the email.

Output

The node outputs JSON data representing the response from the EMM API after creating the recipient. This typically includes details about the newly created recipient such as their ID, email, and any other relevant metadata returned by the API.

No binary data output is produced by this operation.

Dependencies

• Requires an API key credential configured for Basic authentication to access the EMM API.
• Relies on the EMM API endpoints for recipient management.
• Uses dynamic loading methods to fetch available mailing lists and recipient fields from the EMM system for property options.

Troubleshooting

• Error: Missing or invalid email address
  Ensure the "Email" property is provided and correctly formatted as a valid email address.

• Error: Mailing list not found or invalid ID
  When managing subscriptions, verify that the selected mailing list exists and the ID is correct. Use the dynamic selector or expressions carefully.

• API authentication errors
  Confirm that the API key credential is properly set up and has sufficient permissions to create recipients.

• Validation errors on recipient fields
  Make sure all required recipient fields have valid names and values. Invalid or missing fields may cause the API request to fail.

• Network or API downtime issues
  Check connectivity to the EMM API endpoint and ensure the service is operational.

Links and References

• n8n Expressions Documentation — for using expressions in properties like Mailing List ID.
• Refer to your EMM system's API documentation for detailed information on recipient creation and subscription management endpoints.