N8N Tools - Tidio API icon

N8N Tools - Tidio API

Complete Tidio integration - Live chat, AI chatbots, and customer engagement

Actions31

Contact → Delete Contact

AI-generated

Overview

This node integrates with the Tidio API to manage contacts within the Tidio live chat and customer engagement platform. Specifically, the Delete Contact operation allows users to remove a contact from their Tidio account by specifying the contact's unique ID.

This operation is useful in scenarios such as:

  • Cleaning up outdated or invalid contact records.
  • Removing contacts who have unsubscribed or requested deletion.
  • Automating contact lifecycle management workflows.

For example, you might use this node in an automation that deletes contacts after a certain period of inactivity or when they are removed from your CRM system.

Properties

Name Meaning
Contact ID The unique identifier of the contact to delete. This is required to specify which contact to remove.
Additional Fields A collection of optional fields related to contacts (not used for deletion but available for other operations).

Note: For the Delete Contact operation, only the Contact ID property is required and used.

Output

The output JSON contains the response from the Tidio API after attempting to delete the specified contact. Typically, this will include confirmation of deletion or an error message if the operation failed.

Example output structure:

{
  "json": {
    // API response confirming deletion or error details
  },
  "pairedItem": {
    "item": 0
  }
}

No binary data is produced by this operation.

Dependencies

  • Requires an active Tidio API key credential configured in n8n.
  • The node uses the Tidio API endpoint URL and client credentials (Client ID and Client Secret) for authentication.
  • Network access to the Tidio API service is necessary.
  • The node sends requests through a proxy service hosted at https://n8ntools.io/api/v1/proxy/tidio using an additional API key for that proxy.

Troubleshooting

  • Common issues:

    • Invalid or missing Contact ID will cause the API call to fail.
    • Incorrect or expired API credentials will result in authentication errors.
    • Network connectivity problems can prevent successful API calls.

  • Error messages:

    • "Unknown contact operation: deleteContact" — indicates a misconfiguration in the operation parameter; ensure "Delete Contact" is selected.
    • API errors returned from Tidio (e.g., 404 Not Found if the contact does not exist).

  • Resolutions:

    • Verify the Contact ID is correct and exists in your Tidio account.
    • Check that API credentials are valid and have sufficient permissions.
    • Ensure network connectivity and proxy settings allow outbound requests to Tidio API.

Links and References

Discussion