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