Listmonk icon

Listmonk

Interact with a listmonk instance for email marketing and newsletter management. Supports creating subscribers, managing campaigns, sending emails, and more.

Actions32

List → Get

AI-generated

Overview

The node integrates with a list management and email marketing platform, allowing users to interact programmatically with their listmonk instance. Specifically, the "List" resource with the "Get" operation enables retrieving paginated lists of elements (likely mailing lists or subscriber lists) from the service. This is useful for scenarios where you want to fetch and process batches of lists for reporting, synchronization, or further automation workflows.

For example, you might use this node to:

  • Retrieve the first 25 mailing lists to display in a dashboard.
  • Paginate through all available lists to export them or update their details.
  • Automate segmentation or campaign targeting based on list data fetched dynamically.

Properties

Name Meaning
Page The page number to query on (pagination). Must be a positive integer. Default is 1.
Per Page The number of elements to retrieve per page. Controls the batch size of results. Default is 25.

Output

The node outputs JSON data representing the requested page of lists. The structure typically includes an array of list objects, each containing details such as list ID, name, description, and other metadata relevant to the listmonk platform's lists.

If the node supports binary data output, it would generally relate to attachments or media associated with lists or campaigns, but for this operation, the output is purely JSON.

Dependencies

  • Requires connection to a listmonk instance via its API.
  • Needs credentials including domain URL, username, and password for basic authentication.
  • The base URL for API requests is constructed by trimming trailing slashes from the provided domain and appending /api.
  • The node expects the API to respond with JSON content.

Troubleshooting

  • Authentication errors: Ensure that the API credentials (domain, username, password) are correct and have sufficient permissions.
  • Pagination issues: If no results are returned, verify that the Page and Per Page values are within valid ranges and that the lists exist.
  • Network errors: Confirm that the listmonk instance is reachable from n8n and that there are no firewall or connectivity issues.
  • Invalid responses: If the API returns unexpected data, check the version compatibility between the node and the listmonk API.

Links and References

Discussion