From ff5c8e6139005ca97c00d4d7affa5f1359ba5a47 Mon Sep 17 00:00:00 2001 From: adisa narula Date: Wed, 14 Oct 2026 17:50:28 +0100 Subject: [PATCH 1/2] Document role on PUT /contacts/bulk in Preview Co-Authored-By: Claude Opus 5.5 --- descriptions/0/api.intercom.io.yaml | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index d8bffc96..b7ad5ecf 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -10878,6 +10878,13 @@ paths: language_override: de job: id: job_v2_1 + convert_lead_to_user: + summary: Convert a lead to a user + value: + contacts: + - id: abc123 + role: user + external_id: ext123 responses: '202': description: Accepted @@ -32609,6 +32616,14 @@ components: type: string description: The unique identifier for the contact. example: abc123 + role: + type: string + description: The contact's role. Set to `user` to convert a lead + to a user, and any `external_id` in the same object is applied + too. A user can't be converted to a lead, so that contact fails + and the job's `state` ends as `completed_with_errors`. Other values + are ignored. + example: user external_id: type: string description: A unique identifier for the contact which you have From bc7416cb8a2a615d2b0c3743c8a858f70aeac5cf Mon Sep 17 00:00:00 2001 From: adisa narula Date: Wed, 14 Oct 2026 17:57:41 +0100 Subject: [PATCH 2/2] Shorten role description Co-Authored-By: Claude Opus 5.5 --- descriptions/0/api.intercom.io.yaml | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index b7ad5ecf..507b904b 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -32618,11 +32618,7 @@ components: example: abc123 role: type: string - description: The contact's role. Set to `user` to convert a lead - to a user, and any `external_id` in the same object is applied - too. A user can't be converted to a lead, so that contact fails - and the job's `state` ends as `completed_with_errors`. Other values - are ignored. + description: The updated contact's role (optional). example: user external_id: type: string