TouchBasePro icon

TouchBasePro

Interact with TouchBasePro API for Email, WhatsApp, and SMS operations

Actions6

Overview

This node integrates with the TouchBasePro API to manage email subscribers within mailing lists. Specifically, the "Add/Update Subscriber" operation allows users to either add a new subscriber to a specified email list or update an existing subscriber's details. This is useful for maintaining and synchronizing subscriber data in marketing campaigns, newsletters, or any email communication managed through TouchBasePro.

Practical examples include:

  • Adding a new contact to a newsletter list when they sign up on a website.
  • Updating an existing subscriber’s email address or status based on user preferences or bounce notifications.
  • Managing subscriber consent and tracking preferences programmatically.

Properties

Name Meaning
List Name or ID Select the target mailing list by name or ID where the subscriber will be added or updated.
Action Choose whether to "Add" a new subscriber or "Update" an existing one.
Email (Add) The email address of the new subscriber to add (required when adding).
Current Email (Update) The current email address or ID of the subscriber to update (required when updating).
New Email (Update) The new email address to replace the current one (optional when updating).
Name The subscriber's full name (required).
Re-subscribe Boolean flag indicating if the subscriber should be re-subscribed if previously unsubscribed (default: true).
Consent To Track Boolean flag indicating if the subscriber consents to tracking (default: true).
Status The subscriber's status in the list. Options are: Active, Bounced, Deleted, Unconfirmed, Unsubscribed. Default is Active.
Custom Fields A collection of custom fields associated with the subscriber. Each field requires selecting a field name or ID and providing a corresponding value matching the field type. Multiple custom fields can be added.

Output

The node outputs JSON data representing the result of the add or update subscriber operation as returned by the TouchBasePro API. This typically includes confirmation details such as subscriber ID, status, and any metadata related to the subscriber record.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the TouchBasePro API via an API key credential configured in n8n.
  • The node depends on the TouchBasePro service being accessible and the API key having permissions to manage subscribers and lists.
  • Dynamic loading of options (e.g., lists, subscribers, custom fields) relies on API calls to TouchBasePro.

Troubleshooting

  • Common Issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Specifying a non-existent list ID or subscriber email may result in errors or no action.
    • Providing custom field values that do not match the expected type can cause validation errors.
    • Attempting to update a subscriber that does not exist will fail.

  • Error Messages:

    • "Operation 'addOrUpdateSubscriber' not implemented for resource 'email'": Indicates a misconfiguration or unsupported operation; verify the selected resource and operation.
    • API errors related to invalid parameters or permissions will be surfaced from the TouchBasePro API; check the error message for details.

  • Resolution Tips:

    • Ensure the API key is valid and has required permissions.
    • Verify list IDs and subscriber emails exist before attempting updates.
    • Match custom field values to their defined types.
    • Use the "Add" action to create new subscribers before attempting updates.

Links and References

Discussion