BizMail

Overview

This node integrates with the BizMail API to manage email marketing resources such as automations, autoresponders, contacts, and sending emails. Specifically, for the Contact - Create Contact operation, it allows users to create new contact entries in their BizMail account by providing relevant contact details.

Common scenarios where this node is beneficial include:

• Adding new subscribers or contacts collected from forms or other sources into a BizMail contact list.
• Automating contact creation as part of a larger workflow that manages email campaigns.
• Synchronizing external CRM or database contacts with BizMail.

For example, you might use this node to automatically add a new lead captured on your website into your BizMail contacts, ensuring they receive future email campaigns.

Properties

The Merge Fields property is a collection of fields where each entry consists of:

• Field Name or ID: Selectable from a list of available merge fields fetched dynamically from BizMail (e.g., "emails", "first_name", etc.).
• Value: The value to assign to the selected field for the new contact.

In the context of creating a contact, the emails field is mandatory and must be provided within the merge fields.

Output

The node outputs an array with one element per input item. Each element's json property contains the response from the BizMail API after attempting to create the contact.

• On success, the output JSON includes the API response confirming the contact creation.
• On failure (e.g., missing required fields), the output JSON contains an error message describing the issue.

No binary data is produced by this operation.

Dependencies

• Requires an API key credential for BizMail with appropriate permissions.
• The node makes HTTP requests to BizMail endpoints using credentials including app_key and project_token.
• No additional environment variables are needed beyond the configured credentials.

Troubleshooting

• Missing Email Field:
  Error: "Email is required in the "Merge Fields" section."
  Resolution: Ensure that the emails field is included in the merge fields with a valid email address string.

• API Request Failures:
  Errors may occur if the API key or tokens are invalid or expired. Verify that the BizMail API credentials are correctly configured and have necessary access rights.

• Invalid Field Names:
  If a merge field name does not exist or is misspelled, the API may reject the request. Use the dynamic options loader to select valid merge fields.

• Continue On Fail Behavior:
  If enabled, errors for individual items will be returned in the output JSON instead of stopping execution.

Links and References

• BizMail API Documentation (generic link, replace with actual if available)
• n8n Expressions Documentation – for using expressions in field values
• n8n Node Development Guide