N8N Tools - Tidio APIInstall

Overview

This node integrates with the Tidio API to manage contacts and their mailing list subscriptions within a customer engagement platform. Specifically, the "Add to Mailing List" operation allows users to add an existing contact to a specified mailing list by providing the contact's ID and the mailing list ID.

Common scenarios where this node is beneficial include:

• Automatically subscribing contacts to newsletters or promotional mailing lists after they perform certain actions.
• Segmenting contacts into different mailing lists for targeted marketing campaigns.
• Synchronizing contact data between Tidio and other systems via n8n workflows.

For example, after capturing a new lead in a CRM, you can use this node to add that contact to a relevant mailing list in Tidio for email marketing follow-up.

Properties

Note: Although the "Additional Fields" collection contains many options, for the "Add to Mailing List" operation only the "Mailing List ID" is used.

Output

The node outputs a JSON object representing the response from the Tidio API after attempting to add the contact to the mailing list. This typically includes confirmation details such as success status or error messages if the operation failed.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "json": {
    "success": true,
    "contact_id": "12345",
    "mailing_list_id": "67890"
  }
}

If an error occurs, the output JSON will contain an error field with the error message.

Dependencies

• Requires an API key credential for authenticating with the Tidio API.
• The node uses specific HTTP headers including client ID and client secret for authorization.
• The base URL for the Tidio API must be configured in the credentials.
• No additional external dependencies are required beyond the configured Tidio API credentials.

Troubleshooting

• Common Issues:

  • Missing or incorrect Contact ID or Mailing List ID will cause the API call to fail.
  • Invalid or expired API credentials will result in authentication errors.
  • Network connectivity issues may prevent successful API requests.

• Error Messages:

  • "Unknown contact operation: addToMailingList": Indicates a misconfiguration or unsupported operation; ensure the operation name is correct.
  • API errors returned from Tidio will be included in the output JSON under the error field.

• Resolution Tips:

  • Verify that the Contact ID and Mailing List ID exist and are correctly entered.
  • Check that the API credentials are valid and have sufficient permissions.
  • Enable "Continue on Fail" in the node settings to handle errors gracefully in workflows.

Links and References

• Tidio API Documentation (for detailed API endpoints and parameters)
• n8n Documentation (for general usage of custom nodes and credentials)