From a12f1281420d9d35953d5f0977292595e7dcd27b Mon Sep 17 00:00:00 2001 From: mailson Date: Tue, 26 May 2026 08:53:38 -0700 Subject: [PATCH 1/2] Add brand_id to Create Conversation request (Unstable) Documents the optional brand_id parameter added to POST /conversations in intercom/intercom#513021. The parameter allows multi-brand workspaces to associate conversations with a specific brand for correct email notification identity. Co-Authored-By: Claude Opus 4.6 (1M context) --- descriptions/0/api.intercom.io.yaml | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 1b682a2a..a2eda2d7 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -6763,6 +6763,7 @@ paths: type: user id: 6762f11b1bb69f9f2193bba3 body: Hello there + brand_id: "123" contact_not_found: summary: Contact Not Found value: @@ -20601,6 +20602,10 @@ components: format: date-time description: The time the conversation was created as a UTC Unix timestamp. If not provided, the current time will be used. This field is only recommneded for migrating past conversations from another source into Intercom. example: 1671028894 + brand_id: + type: string + description: The unique identifier of the brand to associate with this conversation. Used in multi-brand workspaces to ensure email notifications are sent with the correct brand identity. If not provided, the default brand is used. + example: "123" required: - from - body From 4d76da51382d288f70a0c5236c74e202f1f3db11 Mon Sep 17 00:00:00 2001 From: mailson Date: Tue, 26 May 2026 09:06:15 -0700 Subject: [PATCH 2/2] Shorten brand_id description Co-Authored-By: Claude Opus 4.6 (1M context) --- descriptions/0/api.intercom.io.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index a2eda2d7..fb92ea18 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -20604,7 +20604,7 @@ components: example: 1671028894 brand_id: type: string - description: The unique identifier of the brand to associate with this conversation. Used in multi-brand workspaces to ensure email notifications are sent with the correct brand identity. If not provided, the default brand is used. + description: The unique identifier of the brand to associate with this conversation. example: "123" required: - from