AvantGuard - Acumbamail icon

AvantGuard - Acumbamail

AvantGuard - Acumbamail

Overview

This node integrates with the Acumbamail API to manage email subscribers. Specifically, the "Add Subscriber" operation under the "Subscribers" resource allows users to add a new subscriber to an email list. It supports adding custom merge fields (personalized data tags) for each subscriber and optional parameters such as sending a confirmation email (double opt-in), updating existing subscribers, and returning detailed JSON responses.

Common scenarios include:

  • Adding new contacts to a mailing list with personalized information.
  • Managing subscription preferences by optionally confirming subscriptions via email.
  • Updating subscriber details if they already exist in the list.
  • Retrieving detailed subscriber information immediately after addition.

Practical example:
A marketing automation workflow where new leads collected from a web form are automatically added to an Acumbamail mailing list with their name and preferences stored as merge fields. The workflow can also send a confirmation email to comply with double opt-in requirements.

Properties

Name Meaning
Merge Fields A JSON dictionary of merge tags and their values to personalize subscriber data (e.g., {"FNAME":"John"}).
Additional Body Fields Optional settings including:
• Double Optin: 0 or 1 to activate confirmation email sending.
• Update Subscriber: 0 or 1 to modify existing subscriber data.
• Complete Json: 0 or 1 to return a full JSON response with subscriber details.

Output

The node outputs JSON data representing the result of the add subscriber operation. If the "Complete Json" option is enabled, the output includes a detailed JSON object containing at least the subscriber's email and unique ID. Otherwise, the output may be minimal or confirmation-based.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the Acumbamail service.
  • The node uses the Acumbamail REST API endpoint https://acumbamail.com/api/1.
  • Proper configuration of the API key credential within n8n is necessary.

Troubleshooting

  • Common issues:
    • Invalid or missing API credentials will cause authentication failures.
    • Incorrectly formatted JSON in the "Merge Fields" property may lead to parsing errors.
    • Attempting to add a subscriber that already exists without enabling "Update Subscriber" might result in errors or no changes.
  • Error messages:
    • Authentication errors typically indicate invalid API keys; verify and update credentials.
    • JSON parse errors suggest malformed input in the "Merge Fields" field; ensure valid JSON syntax.
    • API errors about duplicate subscribers can be resolved by enabling the "Update Subscriber" option.

Links and References

Discussion