Skip to content

Commit 314137c

Browse files
docs: Document tag replacement behaviour for Zendesk updates (#3850)
Co-authored-by: Kartik Balasubramanian <22399046+HumanistSerif@users.noreply.github.com>
1 parent 20fb1f0 commit 314137c

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

docs/integrations/builtin/app-nodes/n8n-nodes-base.zendesk.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,18 @@ Refer to [Zendesk credentials](/integrations/builtin/credentials/zendesk.md) for
4646
* Get data related to the organization
4747
* Update a organization
4848

49+
/// warning | Tag Replacement Behavior
50+
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.
51+
52+
**To avoid accidental tag removal:**
53+
54+
- First retrieve the ticket's tags and merge them with your new tags before updating.
55+
- Alternatively, use the HTTP Request node with Zendesk's `additional_tags` property to add tags without removing existing ones.
56+
- 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/)).
57+
58+
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/).
59+
///
60+
4961
## Templates and examples
5062

5163
<!-- see https://www.notion.so/n8n/Pull-in-templates-for-the-integrations-pages-37c716837b804d30a33b47475f6e3780 -->

0 commit comments

Comments
 (0)