From 22e9b20208cec32e2bc94ad2074cbf822dd5b46a Mon Sep 17 00:00:00 2001 From: Ivan Branimir Skoric <58559012+ib-skoric@users.noreply.github.com> Date: Mon, 20 Apr 2026 12:35:04 +0100 Subject: [PATCH 1/2] Add audience targeting fields to Content Import Source Preview spec Add audience_id and apply_audience_to_existing_content fields to the Preview OpenAPI spec (descriptions/0/) for Content Import Sources, per intercom/intercom#497303. Changes: - content_import_source response schema: add audience_id (nullable integer) - create_content_import_source_request: add optional audience_id - update_content_import_source_request: add optional audience_id and apply_audience_to_existing_content (boolean, default false) - All inline response examples updated with audience_id: null --- descriptions/0/api.intercom.io.yaml | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 30a8823..3a567d0 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -642,6 +642,7 @@ paths: sync_behavior: automatic created_at: 1734537259 updated_at: 1734537259 + audience_id: null - id: 34 type: content_import_source last_synced_at: 1734537259 @@ -650,6 +651,7 @@ paths: sync_behavior: automatic created_at: 1734537259 updated_at: 1734537259 + audience_id: null - id: 35 type: content_import_source last_synced_at: 1734537259 @@ -658,6 +660,7 @@ paths: sync_behavior: automatic created_at: 1734537259 updated_at: 1734537259 + audience_id: null pages: type: pages page: 1 @@ -709,6 +712,7 @@ paths: sync_behavior: api created_at: 1734537261 updated_at: 1734537261 + audience_id: null schema: "$ref": "#/components/schemas/content_import_source" '401': @@ -801,6 +805,7 @@ paths: sync_behavior: api created_at: 1734537265 updated_at: 1734537265 + audience_id: null schema: "$ref": "#/components/schemas/content_import_source" '401': @@ -844,6 +849,7 @@ paths: sync_behavior: api created_at: 1734537267 updated_at: 1734537267 + audience_id: null schema: "$ref": "#/components/schemas/content_import_source" '401': @@ -20957,6 +20963,11 @@ components: format: date-time description: The time when the content import source was last updated. example: 1672928610 + audience_id: + type: integer + nullable: true + description: The unique identifier for the audience associated with this content import source. + example: 5678 required: - id - type @@ -22287,6 +22298,11 @@ components: type: string description: The URL of the content import source. example: https://help.example.com + audience_id: + type: integer + nullable: true + description: The unique identifier for the audience to associate with this content import source. + example: 5678 required: - sync_behavior - url @@ -28395,6 +28411,16 @@ components: description: The URL of the content import source. This may only be different from the existing value if the sync behavior is API. example: https://help.example.com + audience_id: + type: integer + nullable: true + description: The unique identifier for the audience to associate with this content import source. Set to null to remove the audience. + example: 5678 + apply_audience_to_existing_content: + type: boolean + description: When true, the audience will be applied to all existing external pages belonging to this content import source. + default: false + example: false required: - sync_behavior - url From 8049c13e7666a1ed191020ccf637255a922f5558 Mon Sep 17 00:00:00 2001 From: Ivan Branimir Skoric <58559012+ib-skoric@users.noreply.github.com> Date: Tue, 21 Apr 2026 14:47:28 +0100 Subject: [PATCH 2/2] Fix audience targeting fields: audience_id -> audience_ids (array) Update Preview spec to match updated PR intercom/intercom#497303: - Rename audience_id to audience_ids throughout - Response schema: type is now array of integers (always returns []) - Request schemas: accept single integer or array via oneOf (nullable) - All inline examples updated to audience_ids: [] --- descriptions/0/api.intercom.io.yaml | 50 ++++++++++++++++++----------- 1 file changed, 31 insertions(+), 19 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 3a567d0..8154efc 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -642,7 +642,7 @@ paths: sync_behavior: automatic created_at: 1734537259 updated_at: 1734537259 - audience_id: null + audience_ids: [] - id: 34 type: content_import_source last_synced_at: 1734537259 @@ -651,7 +651,7 @@ paths: sync_behavior: automatic created_at: 1734537259 updated_at: 1734537259 - audience_id: null + audience_ids: [] - id: 35 type: content_import_source last_synced_at: 1734537259 @@ -660,7 +660,7 @@ paths: sync_behavior: automatic created_at: 1734537259 updated_at: 1734537259 - audience_id: null + audience_ids: [] pages: type: pages page: 1 @@ -712,7 +712,7 @@ paths: sync_behavior: api created_at: 1734537261 updated_at: 1734537261 - audience_id: null + audience_ids: [] schema: "$ref": "#/components/schemas/content_import_source" '401': @@ -805,7 +805,7 @@ paths: sync_behavior: api created_at: 1734537265 updated_at: 1734537265 - audience_id: null + audience_ids: [] schema: "$ref": "#/components/schemas/content_import_source" '401': @@ -849,7 +849,7 @@ paths: sync_behavior: api created_at: 1734537267 updated_at: 1734537267 - audience_id: null + audience_ids: [] schema: "$ref": "#/components/schemas/content_import_source" '401': @@ -20963,11 +20963,13 @@ components: format: date-time description: The time when the content import source was last updated. example: 1672928610 - audience_id: - type: integer - nullable: true - description: The unique identifier for the audience associated with this content import source. - example: 5678 + audience_ids: + type: array + items: + type: integer + description: The unique identifiers for the audiences associated with this content import source. + example: + - 5678 required: - id - type @@ -22298,11 +22300,16 @@ components: type: string description: The URL of the content import source. example: https://help.example.com - audience_id: - type: integer + audience_ids: nullable: true - description: The unique identifier for the audience to associate with this content import source. - example: 5678 + description: The unique identifiers for the audiences to associate with this content import source. Can be a single integer or an array of integers. + example: + - 5678 + oneOf: + - type: integer + - type: array + items: + type: integer required: - sync_behavior - url @@ -28411,11 +28418,16 @@ components: description: The URL of the content import source. This may only be different from the existing value if the sync behavior is API. example: https://help.example.com - audience_id: - type: integer + audience_ids: nullable: true - description: The unique identifier for the audience to associate with this content import source. Set to null to remove the audience. - example: 5678 + description: The unique identifiers for the audiences to associate with this content import source. Can be a single integer or an array of integers. Set to null or an empty array to remove all audiences. + example: + - 5678 + oneOf: + - type: integer + - type: array + items: + type: integer apply_audience_to_existing_content: type: boolean description: When true, the audience will be applied to all existing external pages belonging to this content import source.