Listmonk Tool icon

Listmonk Tool

AI-optimized tool for managing email marketing with Listmonk. Call this tool to create subscribers, send emails, manage campaigns, and handle email marketing operations through natural language.

Get Subscriber by Email

AI-generated

Overview

This node integrates with Listmonk, an email marketing platform, to perform various email marketing operations. Specifically, the "Get Subscriber by Email" operation allows users to search for a subscriber in their mailing lists by providing an email address. This is useful for verifying if a user is already subscribed, retrieving subscriber details for segmentation or personalization, or managing subscriber data.

Practical examples:

  • Before adding a new subscriber, check if the email already exists to avoid duplicates.
  • Retrieve subscriber information to update preferences or attributes.
  • Use subscriber data to trigger personalized email campaigns or workflows.

Properties

Name Meaning
Email to Search The email address of the subscriber you want to find. Must be a valid email format.

Output

The node outputs JSON data representing the subscriber(s) matching the provided email address. The structure typically includes subscriber details such as email, name, status, subscribed lists, and custom attributes. This output can be used downstream in workflows to make decisions or update records.

No binary data output is involved in this operation.

Dependencies

  • Requires connection to a Listmonk instance via its API.
  • Needs an API authentication credential (username and password) configured in n8n credentials.
  • The node uses the base URL from the configured domain credential, appending /api for requests.

Troubleshooting

  • Invalid Email Format: If the input email does not match the required regex pattern, the node will prompt to enter a valid email address.
  • Authentication Errors: Ensure that the API credentials (username, password, and domain) are correctly set up and have sufficient permissions.
  • Subscriber Not Found: If no subscriber matches the email, the output may be empty or null; handle this case in your workflow.
  • API Connectivity Issues: Verify network connectivity to the Listmonk API endpoint and that the service is running.

Links and References

Discussion