diff --git a/api/ticket/index.rst b/api/ticket/index.rst
index b797d5b6..9885a728 100644
--- a/api/ticket/index.rst
+++ b/api/ticket/index.rst
@@ -255,6 +255,22 @@ Update
 
 Required permission: ``ticket.agent`` **or** ``ticket.customer``
 
+.. tip::
+
+   **Suppress notifications**
+
+   To update a ticket without triggering agent notifications (email and
+   in-app), add the following HTTP header to your request:
+
+   .. code-block:: text
+
+      X-Zammad-Suppress-Notifications: true
+
+   This is useful for automated integrations that update tickets via
+   webhooks or triggers to avoid notification loops. The header only affects
+   admin and agent accounts and is ignored for customers. It also works for the
+   ``POST /api/v1/ticket_articles`` endpoint.
+
 ``PUT``-Request sent: ``/api/v1/tickets/{ticket id}``
 
 .. code-block:: json