OpenEMM icon

OpenEMM

Consume EMM API
Join our community

Actions8

Overview

This node integrates with the OpenEMM Email Marketing Manager (EMM) API, enabling users to manage email marketing mailings, recipients, and mailing lists directly within n8n workflows. Specifically, the Mailing - Get operation retrieves detailed information about a specified mailing by its name or ID.

Common scenarios for this node include:

  • Fetching mailing details before sending campaigns.
  • Automating reporting or auditing of mailings.
  • Integrating mailing data into other systems or dashboards.

For example, a user might want to retrieve the configuration and status of a particular mailing campaign to verify its setup or to trigger conditional workflow steps based on mailing properties.

Properties

Name Meaning
Authentication Method of authentication; currently supports only "Basic" authentication using an API key credential.
Mailing Name or ID The identifier or name of the mailing to retrieve. Users can select from a dynamically loaded list or specify an ID via expression. This property is required for the Get operation on the Mailing resource.

Output

The node outputs JSON data representing the mailing's details as returned by the OpenEMM API. The structure typically includes mailing metadata such as mailing ID, name, status, content, scheduling info, and other relevant attributes describing the mailing.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential configured in n8n for authenticating with the OpenEMM API using Basic authentication.
  • Relies on the OpenEMM RESTful API endpoints to fetch mailing data.
  • The node uses internal helper functions to make HTTP GET requests to /mailing/{mailingNameOrId} endpoint.

Troubleshooting

  • Error: Mailing not found or invalid ID
    Ensure that the Mailing Name or ID provided exists in the OpenEMM system. Use the dropdown selector to pick a valid mailing or verify the correctness of the ID if using expressions.

  • Authentication errors
    Verify that the API key credential is correctly set up and has sufficient permissions to access mailing data.

  • Network or API connectivity issues
    Check network connectivity and OpenEMM server availability. Also confirm that the API endpoint URL is correctly configured in the credentials.

  • Invalid JSON or unexpected response
    If the API returns malformed data or unexpected fields, check the OpenEMM API version compatibility and update the node or API accordingly.

Links and References

Discussion