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.

Actions8

Create List

AI-generated

Overview

The node "Listmonk Tool" integrates with the Listmonk email marketing platform, enabling users to manage mailing lists, subscribers, campaigns, and transactional emails through a single interface. Specifically, the Create List operation allows users to create a new mailing list in their Listmonk instance.

This operation is beneficial for marketers and businesses who want to organize their contacts into distinct mailing lists for targeted email campaigns. For example, you might create separate lists for newsletters, product updates, or event invitations.

Practical use cases include:

  • Setting up a new mailing list for a seasonal promotion.
  • Creating segmented lists based on customer interests or demographics.
  • Organizing contacts before launching an email campaign.

Properties

Name Meaning
List Name The name of the mailing list to be created (e.g., "My Mailing List"). Required field.
List Type The visibility type of the mailing list. Options: Public or Private.
Opt-in Type The subscription confirmation method. Options: Single (immediate subscription) or Double (requires confirmation).
List Description A textual description of the mailing list, explaining its purpose or content.
Tags (JSON) An array of tags associated with the list, e.g., ["newsletter", "updates"], used for categorization or filtering.

Output

The output of the Create List operation is the JSON response returned by the Listmonk API after creating the mailing list. This typically includes details about the newly created list such as its ID, name, type, opt-in setting, description, tags, and other metadata.

No binary data is produced by this operation.

Dependencies

  • Requires connection to a Listmonk instance via its REST API.
  • Needs credentials including:
    • The domain URL of the Listmonk API.
    • Username and password for basic authentication.
  • The node expects these credentials to be configured in n8n prior to execution.

Troubleshooting

  • Invalid Credentials: If authentication fails, verify that the username, password, and domain URL are correct and that the Listmonk instance is accessible.
  • Missing Required Fields: The "List Name" property is mandatory. Ensure it is provided; otherwise, the API will reject the request.
  • Malformed Tags JSON: The "Tags" field must be valid JSON representing an array. Invalid JSON will cause errors.
  • API Endpoint Issues: Confirm that the Listmonk API endpoint /lists is reachable and that the user has permission to create lists.
  • Opt-in Type Errors: Use only the allowed values (single or double) for the opt-in type to avoid validation errors.

Links and References

Discussion