From 4ccbc1642b232a38a4f3f2365f3d9eb7640fd2d9 Mon Sep 17 00:00:00 2001 From: Sean Healy Date: Tue, 18 Aug 2026 14:48:26 +0100 Subject: [PATCH 1/3] Document fin_phone_number on the Fin Voice register endpoint Co-Authored-By: Claude Opus 5 (1M context) --- descriptions/0/api.intercom.io.yaml | 14 ++++++++++++++ descriptions/2.15/api.intercom.io.yaml | 14 ++++++++++++++ descriptions/2.16/api.intercom.io.yaml | 14 ++++++++++++++ 3 files changed, 42 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 56bb766e..ec4e70cd 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -41058,6 +41058,11 @@ components: type: string description: Phone number in E.164 format for the call example: '+1234567890' + fin_phone_number: + type: string + nullable: true + description: The number Fin Voice is dialled into, as supplied when the call was registered + example: '+1234567890' status: type: string description: Status of the call. Can be "registered", "in-progress", or a resolution state @@ -41109,6 +41114,15 @@ components: type: string description: External call identifier from the call provider example: 'call-123-abc' + fin_phone_number: + type: string + nullable: true + description: >- + The number Fin Voice is dialled into, in E.164 format. Set this when the call reaches + Intercom over SIP or an external transfer, where Intercom cannot determine the number + the caller dialled. The country code is required; a number without one is ignored. If + omitted, Intercom uses the workspace phone number. + example: '+1234567890' source: type: string description: Source of the call. Can be "five9", "zoom_phone", or defaults to "aws_connect" diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index 49ae729c..7e66a6d0 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -15929,6 +15929,11 @@ components: type: string description: Phone number in E.164 format for the call example: '+1234567890' + fin_phone_number: + type: string + nullable: true + description: The number Fin Voice is dialled into, as supplied when the call was registered + example: '+1234567890' status: type: string description: Status of the call. Can be "registered", "in-progress", or a resolution state @@ -22373,6 +22378,15 @@ components: type: string description: External call identifier from the call provider example: 'call-123-abc' + fin_phone_number: + type: string + nullable: true + description: >- + The number Fin Voice is dialled into, in E.164 format. Set this when the call reaches + Intercom over SIP or an external transfer, where Intercom cannot determine the number + the caller dialled. The country code is required; a number without one is ignored. If + omitted, Intercom uses the workspace phone number. + example: '+1234567890' source: type: string description: Source of the call. Can be "five9", "zoom_phone", or defaults to "aws_connect" diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index 5b27176d..b88e1034 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -23223,6 +23223,11 @@ components: type: string description: Phone number in E.164 format for the call example: '+1234567890' + fin_phone_number: + type: string + nullable: true + description: The number Fin Voice is dialled into, as supplied when the call was registered + example: '+1234567890' status: type: string description: Status of the call. Can be "registered", "in-progress", or a resolution state @@ -33114,6 +33119,15 @@ components: type: string description: External call identifier from the call provider example: 'call-123-abc' + fin_phone_number: + type: string + nullable: true + description: >- + The number Fin Voice is dialled into, in E.164 format. Set this when the call reaches + Intercom over SIP or an external transfer, where Intercom cannot determine the number + the caller dialled. The country code is required; a number without one is ignored. If + omitted, Intercom uses the workspace phone number. + example: '+1234567890' source: type: string description: Source of the call. Can be "five9", "zoom_phone", or defaults to "aws_connect" From 8e7f28282e4e684e2c9fa3a09124fe9daee1206e Mon Sep 17 00:00:00 2001 From: Sean Healy Date: Wed, 19 Aug 2026 16:03:54 +0100 Subject: [PATCH 2/3] Scope fin_phone_number to the Preview description The field is available from the Preview version onward, so the 2.15 and 2.16 descriptions should not declare it. Co-Authored-By: Claude Opus 5 (1M context) --- descriptions/2.15/api.intercom.io.yaml | 14 -------------- descriptions/2.16/api.intercom.io.yaml | 14 -------------- 2 files changed, 28 deletions(-) diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index 7e66a6d0..49ae729c 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -15929,11 +15929,6 @@ components: type: string description: Phone number in E.164 format for the call example: '+1234567890' - fin_phone_number: - type: string - nullable: true - description: The number Fin Voice is dialled into, as supplied when the call was registered - example: '+1234567890' status: type: string description: Status of the call. Can be "registered", "in-progress", or a resolution state @@ -22378,15 +22373,6 @@ components: type: string description: External call identifier from the call provider example: 'call-123-abc' - fin_phone_number: - type: string - nullable: true - description: >- - The number Fin Voice is dialled into, in E.164 format. Set this when the call reaches - Intercom over SIP or an external transfer, where Intercom cannot determine the number - the caller dialled. The country code is required; a number without one is ignored. If - omitted, Intercom uses the workspace phone number. - example: '+1234567890' source: type: string description: Source of the call. Can be "five9", "zoom_phone", or defaults to "aws_connect" diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index b88e1034..5b27176d 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -23223,11 +23223,6 @@ components: type: string description: Phone number in E.164 format for the call example: '+1234567890' - fin_phone_number: - type: string - nullable: true - description: The number Fin Voice is dialled into, as supplied when the call was registered - example: '+1234567890' status: type: string description: Status of the call. Can be "registered", "in-progress", or a resolution state @@ -33119,15 +33114,6 @@ components: type: string description: External call identifier from the call provider example: 'call-123-abc' - fin_phone_number: - type: string - nullable: true - description: >- - The number Fin Voice is dialled into, in E.164 format. Set this when the call reaches - Intercom over SIP or an external transfer, where Intercom cannot determine the number - the caller dialled. The country code is required; a number without one is ignored. If - omitted, Intercom uses the workspace phone number. - example: '+1234567890' source: type: string description: Source of the call. Can be "five9", "zoom_phone", or defaults to "aws_connect" From afe0219f0c8b273e33c3f89a4d3cadd64e46e537 Mon Sep 17 00:00:00 2001 From: Sean Healy Date: Wed, 19 Aug 2026 17:50:34 +0100 Subject: [PATCH 3/3] Clarify when to set the Fin Voice declared line Co-Authored-By: Claude Opus 5 (1M context) --- descriptions/0/api.intercom.io.yaml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index ec4e70cd..130275c1 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -41118,10 +41118,10 @@ components: type: string nullable: true description: >- - The number Fin Voice is dialled into, in E.164 format. Set this when the call reaches - Intercom over SIP or an external transfer, where Intercom cannot determine the number - the caller dialled. The country code is required; a number without one is ignored. If - omitted, Intercom uses the workspace phone number. + The number Fin Voice is dialled into, in E.164 format. Set this when you register a + call forwarded through your own telephony platform, where Intercom cannot determine + the number the caller dialled. The country code is required; a number without one is + ignored. If omitted, Intercom uses the workspace phone number. example: '+1234567890' source: type: string