TouchBasePro icon

TouchBasePro

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

Actions6

Overview

This node integrates with the TouchBasePro API to send transactional smart emails using predefined templates. It is designed for scenarios where you want to automate sending personalized, template-based emails triggered by workflows, such as order confirmations, password resets, or notification alerts.

By selecting a smart email template and specifying recipients along with optional CC, BCC, attachments, and merge fields, users can send customized emails efficiently. The node also supports tracking options and suppression list handling to manage email deliverability and compliance.

Practical examples:

  • Sending a welcome email to new users after signup.
  • Dispatching order shipment notifications with dynamic order details.
  • Sending password reset instructions with personalized links.

Properties

Name Meaning
Smart Email Template Name or ID Select a transactional smart email template from your TouchBasePro account by name or ID. This defines the email content and layout.
To List of primary recipients. Each recipient can have a name and an email address. Multiple recipients can be added.
CC List of CC (carbon copy) recipients. Similar structure to "To".
BCC List of BCC (blind carbon copy) recipients. Similar structure to "To".
Attachments Files to attach to the email. For each attachment, specify the name, type, and the binary property field from previous nodes containing the file data.
Merge Fields Dynamic fields to replace placeholders in the selected email template. Each merge field has a name or ID and a corresponding value.
Allow Tracking Boolean flag to enable or disable tracking of email opens and clicks. Defaults to true (tracking enabled).
Ignore Suppression List Boolean flag to decide whether to ignore the suppression list when sending the email. Defaults to true (suppression list ignored).
Add Recipient To List Boolean flag indicating whether to add the email recipient to a mailing list after sending. Defaults to true.

Output

The node outputs an array of JSON objects, each representing the response from the TouchBasePro API for the sent email operation. The exact structure depends on the API response but typically includes status information about the email dispatch.

No binary data output is produced by this operation.

Dependencies

  • Requires an active TouchBasePro API key credential configured in n8n.
  • Depends on the availability of predefined smart email templates in the TouchBasePro account.
  • Network access to the TouchBasePro API endpoint is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Specifying a non-existent or unauthorized smart email template ID/name will result in errors.
    • Incorrectly formatted recipient email addresses may cause the API to reject the request.
    • Missing required merge fields for the selected template can lead to incomplete or failed email sends.

  • Error messages:

    • "Operation 'sendSmartEmail' not implemented for resource 'email'": Indicates a misconfiguration or unsupported operation; verify the resource and operation parameters.
    • API errors related to invalid template IDs or missing parameters should be resolved by checking the input properties and ensuring all required fields are correctly set.
    • Network or timeout errors require checking connectivity and API service status.

Links and References

Discussion