From f6015939b9ee16d45cd950ccd5c32344602d9986 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sven=20H=C3=BCster?= Date: Tue, 31 Mar 2026 12:32:47 +0200 Subject: [PATCH 1/2] Clarify message attachment rendering in webhooks Added a section explaining message attachment rendering requirements for webhooks. --- site/content/integrate/webhooks/incoming/_index.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/site/content/integrate/webhooks/incoming/_index.md b/site/content/integrate/webhooks/incoming/_index.md index 7890a102e0..0084568d76 100644 --- a/site/content/integrate/webhooks/incoming/_index.md +++ b/site/content/integrate/webhooks/incoming/_index.md @@ -197,5 +197,9 @@ Some common error messages include: If your integration prints the JSON payload data instead of rendering the generated message, make sure your integration is returning the `application/json` content-type. +#### Why aren't my message attachments rendering? + +Make sure `attachments` is a **top-level field** in your webhook JSON payload, not nested inside `props`. While the REST API uses `props.attachments`, incoming webhooks expect `attachments` at the top level. + For further assistance, review the {{< newtabref href="https://forum.mattermost.org/t/how-to-use-the-troubleshooting-forum/150" title="Troubleshooting forum" >}} for previously reported errors, or {{< newtabref href="https://mattermost.com/pl/default-ask-mattermost-community/" title="join the Mattermost user community" >}} for troubleshooting help. From 12714d6de2b33cb9a9a73a4368019ae3549bfa5c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sven=20H=C3=BCster?= Date: Tue, 31 Mar 2026 12:41:50 +0200 Subject: [PATCH 2/2] Update site/content/integrate/webhooks/incoming/_index.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- site/content/integrate/webhooks/incoming/_index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/site/content/integrate/webhooks/incoming/_index.md b/site/content/integrate/webhooks/incoming/_index.md index 0084568d76..91f3cd05b8 100644 --- a/site/content/integrate/webhooks/incoming/_index.md +++ b/site/content/integrate/webhooks/incoming/_index.md @@ -198,7 +198,6 @@ Some common error messages include: If your integration prints the JSON payload data instead of rendering the generated message, make sure your integration is returning the `application/json` content-type. #### Why aren't my message attachments rendering? - Make sure `attachments` is a **top-level field** in your webhook JSON payload, not nested inside `props`. While the REST API uses `props.attachments`, incoming webhooks expect `attachments` at the top level. For further assistance, review the {{< newtabref href="https://forum.mattermost.org/t/how-to-use-the-troubleshooting-forum/150" title="Troubleshooting forum" >}} for previously reported errors, or {{< newtabref href="https://mattermost.com/pl/default-ask-mattermost-community/" title="join the Mattermost user community" >}} for troubleshooting help.