Mindz icon

Mindz

Interact with Mindz API
Join our community

Actions116

Overview

The node integrates with the Mindz API to manage email contacts within specified email lists. Specifically, the Email - Create operation allows users to add a new email contact to an existing email list in the Mindz system. This is useful for automating contact management workflows such as subscribing new users, importing contacts from other systems, or dynamically building mailing lists based on user actions.

Practical examples:

  • Automatically adding a new customer’s email to a marketing list after they sign up on a website.
  • Importing a batch of contacts into a specific email list for a targeted campaign.
  • Subscribing users to newsletters or notification lists programmatically.

Properties

Name Meaning
Email List ID The unique identifier of the email list to which the new email contact will be added.
Email Address The email address of the contact to create and add to the list.
First Name (Optional) The first name of the contact.
Last Name (Optional) The last name of the contact.
Is Subscribed Whether the contact should be marked as subscribed to the email list (true/false).

Output

The node outputs JSON data representing the newly created email contact as returned by the Mindz API. This typically includes fields such as the contact's ID, email address, subscription status, and any associated metadata like first and last names.

If the node supports binary data output (not indicated here), it would represent attachments or related files, but for this operation, the output is purely JSON-based contact information.

Dependencies

  • Requires an active connection to the Mindz API via an OAuth2 authentication credential configured in n8n.
  • The node depends on the Mindz API being accessible and the provided API credentials having permissions to manage email lists and contacts.

Troubleshooting

  • Common issues:

    • Invalid or missing Email List ID: Ensure the email list ID exists and is correctly entered.
    • Invalid email format: The email address must be valid; otherwise, the API may reject the request.
    • Authentication errors: Verify that the OAuth2 credentials are valid and have not expired.
    • Permission denied: The API key used must have rights to add contacts to the specified email list.

  • Error messages:

    • "Email list not found": Check that the Email List ID corresponds to an existing list.
    • "Invalid email address": Confirm the email address format is correct.
    • "Unauthorized" or "Authentication failed": Reauthenticate or update the API credentials.
    • "Subscription status invalid": Ensure the Is Subscribed property is a boolean value.

Links and References

Discussion