Mindz icon

Mindz

Interact with Mindz API

Actions115

Overview

The node interacts with the Mindz API to manage email campaign excluded lists. Specifically, the List operation under the Email Campaign Excluded List resource retrieves a paginated list of contacts or entries that have been excluded from a particular email campaign. This is useful for marketers and automation specialists who want to review or audit which recipients are excluded from receiving certain email campaigns, ensuring compliance with preferences or regulations.

Practical examples:

  • Fetching all users excluded from an email campaign to verify exclusion criteria.
  • Auditing excluded contacts before launching a new campaign to avoid sending emails to unsubscribed or blocked addresses.
  • Integrating with other systems to synchronize exclusion lists for consistent marketing communications.

Properties

Name Meaning
Email Campaign ID The unique identifier of the email campaign whose excluded list you want to retrieve.
Limit Maximum number of results to return in one request (minimum 1). Defaults to 50.
Offset Number of results to skip before starting to collect the result set. Useful for paging.

Output

The output contains a JSON array of excluded list entries related to the specified email campaign. Each entry typically includes details about the excluded contact or entity, such as email address, exclusion reason, timestamps, or identifiers depending on the Mindz API response structure.

If the node supports binary data output (not indicated here), it would represent attachments or files related to the excluded list, but this node primarily outputs JSON data.

Dependencies

  • Requires an active connection to the Mindz API via an OAuth2-based API key credential configured in n8n.
  • The node depends on the Mindz API endpoints for email campaign management.
  • Proper permissions on the Mindz account to access email campaign exclusion data are necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Email Campaign ID will cause the API call to fail.
    • Insufficient permissions or expired API credentials may result in authentication errors.
    • Requesting too large a limit might be rejected by the API or cause timeouts.
  • Error messages and resolutions:

    • "Unauthorized" or "Authentication failed": Check and refresh the API credentials.
    • "Invalid Email Campaign ID": Verify the campaign ID exists and is correctly entered.
    • "Rate limit exceeded": Reduce request frequency or implement retries with backoff.
    • "Offset out of range": Adjust offset value within the total number of available records.

Links and References


Note: The summary is based on static analysis of the bundled source code and provided property definitions without runtime execution or dynamic import resolution.

Discussion