From ab1773e3dcc9a5a0ebdc87caaddba04030bed8f7 Mon Sep 17 00:00:00 2001
From: Cathal Ging <cathal.ging@intercom.io>
Date: Wed, 2 Sep 2026 14:09:03 +0100
Subject: [PATCH] Clarify that <div> is stripped and still suppresses the
 translated topic
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The caveat added in #638 says the translated-reply webhook topic is
suppressed when body has text outside an HTML block element, which
invites reaching for <div> — not in the admin sanitizer allowlist, so
it's stripped on save and the topic stays suppressed anyway.
---
 descriptions/0/api.intercom.io.yaml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml
index cd079d8..eb33e06 100644
--- a/descriptions/0/api.intercom.io.yaml
+++ b/descriptions/0/api.intercom.io.yaml
@@ -32648,6 +32648,9 @@ components:
             every translated reply: it is suppressed when the reply's `body` contains
             any text outside an HTML block element, which includes plain-text replies
             created through the REST API.
+            Wrap the body in `<p>` or another supported block element to avoid this;
+            `<div>` is removed when the reply is saved, which leaves its text bare and
+            still suppresses the topic.
           required:
             - original
           additionalProperties:
@@ -40361,6 +40364,9 @@ components:
             every translated reply: it is suppressed when the reply's `body` contains
             any text outside an HTML block element, which includes plain-text replies
             created through the REST API.
+            Wrap the body in `<p>` or another supported block element to avoid this;
+            `<div>` is removed when the reply is saved, which leaves its text bare and
+            still suppresses the topic.
           required:
             - original
           additionalProperties:
@@ -40553,6 +40559,9 @@ components:
             every translated reply: it is suppressed when the reply's `body` contains
             any text outside an HTML block element, which includes plain-text replies
             created through the REST API.
+            Wrap the body in `<p>` or another supported block element to avoid this;
+            `<div>` is removed when the reply is saved, which leaves its text bare and
+            still suppresses the topic.
           required:
             - original
           additionalProperties: