Mindz icon

Mindz

Interact with Mindz API

Actions116

Overview

This node interacts with the Mindz API to manage email campaign excluded lists. Specifically, the Create operation for the Email Campaign Excluded List resource allows users to add a list to the exclusion lists of an email campaign. This means that recipients in the specified list will be excluded from receiving emails sent as part of that campaign.

Common scenarios where this node is beneficial include:

  • Preventing certain groups (e.g., unsubscribed users, internal staff) from receiving specific email campaigns.
  • Managing targeted marketing by excluding segments dynamically.
  • Automating exclusion list updates based on external triggers or workflows.

For example, you might use this node to automatically exclude a "Do Not Email" list from a promotional campaign before sending it out.

Properties

Name Meaning
Email Campaign ID The unique identifier of the email campaign to which you want to add an excluded list.
List ID The unique identifier of the list that should be added to the campaign's excluded lists.

Output

The node outputs JSON data representing the result of adding the specified list to the email campaign's excluded lists. Typically, this output includes confirmation details such as IDs and status indicating the exclusion was successfully applied.

If the API supports it, the output may also contain metadata about the updated campaign exclusion settings.

No binary data output is expected from this operation.

Dependencies

  • Requires an active connection to the Mindz API via an OAuth2-based API key credential.
  • The user must have appropriate permissions to modify email campaign exclusions in the Mindz system.
  • Proper configuration of the Mindz OAuth2 credentials within n8n is necessary.

Troubleshooting

  • Invalid Email Campaign ID or List ID: If either ID is incorrect or does not exist, the API will likely return an error. Verify the IDs are correct and correspond to existing resources.
  • Authentication Errors: Ensure the OAuth2 credentials are valid and have not expired.
  • Permission Denied: The authenticated user must have rights to modify the email campaign's excluded lists.
  • Network Issues: Connectivity problems can cause request failures; check network access to the Mindz API endpoint.

Common error messages might include:

  • "Resource not found" — Check if the provided campaign or list ID exists.
  • "Unauthorized" or "Invalid token" — Refresh or reconfigure the API authentication.
  • "Forbidden" — Confirm user permissions.

Resolving these typically involves verifying input parameters, refreshing credentials, and ensuring proper API access rights.

Links and References

  • Mindz API Documentation (general reference for endpoints related to email campaigns and lists)
  • n8n OAuth2 Credential Setup Guide
  • Best practices for managing email campaign exclusions in Mindz platform

Discussion