From a9928b6aec0fd26ed75994db432f1f4e64ef5f2c Mon Sep 17 00:00:00 2001 From: jabbson Date: Mon, 3 Nov 2025 14:28:02 -0400 Subject: [PATCH] Document tag replacement behaviour for Zendesk updates Added warning about tag replacement behaviour when updating tickets in Zendesk. --- .../builtin/app-nodes/n8n-nodes-base.zendesk.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/integrations/builtin/app-nodes/n8n-nodes-base.zendesk.md b/docs/integrations/builtin/app-nodes/n8n-nodes-base.zendesk.md index 539b400c4fc..7a98faa2fd5 100644 --- a/docs/integrations/builtin/app-nodes/n8n-nodes-base.zendesk.md +++ b/docs/integrations/builtin/app-nodes/n8n-nodes-base.zendesk.md @@ -46,6 +46,18 @@ Refer to [Zendesk credentials](/integrations/builtin/credentials/zendesk.md) for * Get data related to the organization * Update a organization +/// warning | Tag Replacement Behavior +When using the Zendesk node's "Update Ticket" operation and specifying the `Tag Names or IDs` field, the entire list of tags on the ticket **will be replaced**. Any tags not included in the update will be removed from the ticket due to how the Zendesk API processes tag updates by default. + +**To avoid accidental tag removal:** + +- First retrieve the ticket's tags and merge them with your new tags before updating. +- Alternatively, use the HTTP Request node with Zendesk's `additional_tags` property to add tags without removing existing ones. +- You can also call the ticket's `/tags` endpoint to add tags without replacing existing ones ([Zendesk tags endpoint documentation](https://developer.zendesk.com/api-reference/ticketing/ticket-management/tags/)). + +See the official documentation for details: [Adding tags to tickets without overwriting existing tags](https://developer.zendesk.com/documentation/ticketing/managing-tickets/adding-tags-to-tickets-without-overwriting-existing-tags/). +/// + ## Templates and examples