Actions8
Create Campaign
AI-generatedOverview
The node provides an interface to manage email marketing campaigns using the Listmonk platform. Specifically, the Create Campaign operation allows users to create a new email campaign by specifying details such as the campaign name, subject, content, and target mailing lists. This is useful for marketers who want to automate the creation of email campaigns within their workflows, enabling them to schedule and send targeted emails efficiently.
Typical use cases include:
- Launching promotional email campaigns to specific subscriber lists.
- Automating newsletter creation with custom HTML or text content.
- Scheduling campaigns to be sent at a future date/time.
Properties
| Name | Meaning |
|---|---|
| Campaign Name | The name/title of the email campaign being created. |
| Campaign Subject | The subject line that recipients will see in their email inbox. |
| Campaign Body | The main content of the email campaign, provided as HTML code. |
| Lists (JSON) | JSON array of list IDs representing the mailing lists to which the campaign will be sent. |
| Content Type | Format of the campaign content. Options: HTML, Plain Text, Markdown, Rich Text. |
| Template ID | Numeric ID of the email template to use for the campaign. |
| Send At (Optional) | ISO 8601 datetime string specifying when to send the campaign. Leave empty for immediate sending. |
Output
The node outputs the response from the Listmonk API after creating the campaign. The json output field contains the newly created campaign's data, including its unique ID and all properties as stored on the server. This allows subsequent nodes to reference the campaign for further actions like sending or retrieving statistics.
No binary data is produced by this operation.
Dependencies
- Requires connection to a Listmonk instance via its REST API.
- Needs credentials including domain URL, username, and password for authentication.
- The node expects the Listmonk API to be accessible and properly configured to accept campaign creation requests.
Troubleshooting
- Invalid JSON in Lists (JSON): If the list IDs JSON is malformed, the API request will fail. Ensure the input is a valid JSON array of numbers.
- Authentication Errors: Incorrect or missing API credentials will cause authorization failures. Verify the API key or username/password are correct.
- Invalid Date Format for Send At: The
sendAtproperty must be a valid ISO 8601 datetime string or left empty. Invalid formats may cause errors. - Missing Required Fields: Omitting required fields like campaign name or subject may result in API validation errors.
- API Endpoint Unreachable: Network issues or incorrect domain configuration can prevent communication with the Listmonk API.