Listmonk icon

Listmonk

Interact with Listmonk API

Actions71

Overview

This node operation manages blocklist subscribers by their IDs in the Listmonk system. It allows users to add, remove, or unsubscribe subscribers from blocklists based on their subscriber IDs. This is useful for email marketing or communication platforms where managing subscriber status and blocklists is essential to maintain compliance and improve deliverability. For example, a user can batch add multiple subscribers to a blocklist or remove them from it to control who receives communications.

Use Case Examples

  1. Add multiple subscribers to a blocklist by providing their IDs and specifying the 'add' action.
  2. Remove subscribers from a blocklist by specifying their IDs and using the 'remove' action.
  3. Unsubscribe subscribers from all communications by using the 'unsubscribe' action with their IDs.

Properties

Name Meaning
Id The unique identifier of the subscriber to be blocklisted.
Query A query string to filter or specify additional parameters for the operation.
Ids A JSON array of subscriber IDs to be modified in the blocklist.
Action The action to perform on the subscribers: add to blocklist, remove from blocklist, or unsubscribe.
Target List Ids IDs of the lists to be modified in relation to the subscribers.
Status The status of the subscribers: confirmed, unconfirmed, or unsubscribed.
Request Options Additional request options such as batching, SSL certificate validation, proxy settings, and timeout configuration.

Output

JSON

  • id - The ID of the subscriber affected by the blocklist operation.
  • status - The status of the subscriber after the operation.
  • action - The action performed on the subscriber (add, remove, unsubscribe).
  • target_list_ids - The list IDs affected by the operation.

Dependencies

  • Requires an API key credential for authenticating with the Listmonk API.

Troubleshooting

  • Ensure the subscriber IDs provided are valid and exist in the system to avoid errors.
  • Check API credentials and base URL configuration if authentication errors occur.
  • If batching is enabled, verify batch size and interval settings to prevent request throttling issues.
  • SSL certificate validation errors can be bypassed by enabling the 'Ignore SSL Issues' option, but this should be used cautiously.

Discussion