Listmonk icon

Listmonk

Interact with a listmonk instance

Overview

The node provides integration with a list management and email campaign platform called Listmonk. Specifically, the "Campaign" resource with the "Update" operation allows users to modify existing email campaigns by sending updated data in JSON format. This is useful for scenarios where you need to change campaign details such as content, scheduling, or targeting after the campaign has been created but before it is sent.

Practical examples include:

  • Updating the subject line or body of an email campaign.
  • Changing the recipient list or segmentation criteria.
  • Modifying scheduling parameters like send time.

Properties

Name Meaning
ID The unique identifier of the campaign to update. This is required to specify which campaign to modify.
Json Body The JSON object containing the fields and values to update in the campaign. This can include any updatable campaign attributes supported by the API.

Output

The node outputs JSON data representing the response from the Listmonk API after attempting to update the campaign. This typically includes confirmation of the update, the updated campaign details, or error information if the update failed.

No binary data output is indicated.

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 from the provided domain credential.
  • The node expects the API to accept and return JSON-formatted data.

Troubleshooting

  • Common issues:

    • Invalid or missing campaign ID will cause the update to fail.
    • Malformed JSON in the "Json Body" property may result in API errors.
    • Authentication failures due to incorrect credentials or domain URL.
    • Network connectivity issues to the Listmonk server.
  • Error messages:

    • Errors returned from the API will typically indicate the reason (e.g., "Campaign not found", "Invalid JSON").
    • Authentication errors might show as HTTP 401 Unauthorized.
  • Resolutions:

    • Verify the campaign ID exists and is correct.
    • Ensure the JSON body is valid and matches expected schema.
    • Check credentials and domain URL for correctness.
    • Confirm network access to the Listmonk API endpoint.

Links and References

Discussion