Actions32
- Campaign Actions
- List Actions
- Media Actions
- Setting Actions
- Subscriber Actions
- Template Actions
- Transaction Actions
Overview
The node "Listmonk" allows interaction with a listmonk instance, which is an open-source self-hosted newsletter and mailing list manager. This node facilitates managing mailing lists, campaigns, subscribers, templates, media, and other related resources within listmonk.
Specifically, the Create List operation under the List resource enables users to create a new mailing list in their listmonk instance by sending a JSON body describing the list's properties. This operation is useful for automating the setup of mailing lists, integrating list creation into workflows, or dynamically managing subscriber groups.
Practical examples include:
- Automatically creating a new mailing list when a new project or event is initiated.
- Setting up segmented mailing lists based on user input or external data.
- Integrating list creation as part of a larger marketing automation workflow.
Properties
| Name | Meaning |
|---|---|
| Json Body | The JSON object containing the details of the mailing list to be created. This should conform to the listmonk API's expected format for list creation. |
Output
The node outputs JSON data representing the response from the listmonk API after attempting to create the list. This typically includes information about the newly created list such as its ID, name, and other metadata returned by the API.
If the operation is successful, the output JSON will confirm the creation and provide details that can be used in subsequent workflow steps.
No binary data output is indicated for this operation.
Dependencies
- Requires access to a running listmonk instance with API enabled.
- Requires credentials including:
- Domain URL of the listmonk instance.
- Username and password for basic authentication.
- The node uses these credentials to authenticate API requests.
- Proper network connectivity to the listmonk server is necessary.
Troubleshooting
- Authentication errors: Ensure the username, password, and domain URL are correct and that the API endpoint is accessible.
- Invalid JSON Body: The JSON provided must match the expected schema for list creation in listmonk. Invalid or incomplete JSON will cause API errors.
- Network issues: Verify that the listmonk server is reachable from n8n and that no firewall or proxy blocks the request.
- API errors: Check the response message for specific API error codes or messages to adjust the JSON body or credentials accordingly.
Links and References
- listmonk Official Documentation
- listmonk API Reference (for JSON body structure and endpoints)