From 92c3767fc8193e858610f737d58c5d7a169e94ca Mon Sep 17 00:00:00 2001 From: Varshini Suresh Date: Wed, 4 Nov 2026 11:28:18 +0000 Subject: [PATCH 1/3] Document signed_up_at, last_seen_at and SMS consent on bulk contact updates (Preview) Co-Authored-By: Claude Opus 5.5 --- descriptions/0/api.intercom.io.yaml | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 15765dcd..6d3589a2 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -42191,6 +42191,26 @@ components: type: string description: The updated contact's role (optional). example: user + signed_up_at: + type: integer + format: date-time + nullable: true + description: "(Unix timestamp in seconds) The time specified for when a contact signed up." + example: 1571672154 + last_seen_at: + type: integer + format: date-time + nullable: true + description: "(Unix timestamp in seconds) The time when the contact was last seen." + example: 1571672154 + sms_consent: + type: boolean + description: Whether the contact has consented to receive SMS messages. + example: false + unsubscribed_from_sms: + type: boolean + description: Whether the contact is unsubscribed from SMS messages. + example: false external_id: type: string description: A unique identifier for the contact which you have From 7df7958f200610acc2d11dd666842938e6e54426 Mon Sep 17 00:00:00 2001 From: Varshini Suresh Date: Wed, 4 Nov 2026 11:57:34 +0000 Subject: [PATCH 2/3] Add a bulk update request example for the new contact fields Co-Authored-By: Claude Opus 5.5 --- descriptions/0/api.intercom.io.yaml | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 6d3589a2..c7391293 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -15689,6 +15689,15 @@ paths: - id: abc123 role: user external_id: ext123 + update_timestamps_and_sms_consent: + summary: Update timestamps and SMS consent + value: + contacts: + - id: abc123 + signed_up_at: 1571672154 + last_seen_at: 1571672154 + sms_consent: true + unsubscribed_from_sms: false responses: '202': description: Accepted From dd60683de6c8a73f7c0ce609bba65d8ff2122e8d Mon Sep 17 00:00:00 2001 From: Varshini Suresh Date: Wed, 4 Nov 2026 12:00:32 +0000 Subject: [PATCH 3/3] Show the new contact fields in the successful bulk update example Co-Authored-By: Claude Opus 5.5 --- descriptions/0/api.intercom.io.yaml | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index c7391293..9faa30e7 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -15642,6 +15642,10 @@ paths: avatar: https://www.example.com/avatar_image.jpg owner_id: "321" unsubscribed_from_emails: false + signed_up_at: 1571672154 + last_seen_at: 1571672154 + sms_consent: true + unsubscribed_from_sms: false language_override: fr custom_attributes: plan: pro @@ -15689,15 +15693,6 @@ paths: - id: abc123 role: user external_id: ext123 - update_timestamps_and_sms_consent: - summary: Update timestamps and SMS consent - value: - contacts: - - id: abc123 - signed_up_at: 1571672154 - last_seen_at: 1571672154 - sms_consent: true - unsubscribed_from_sms: false responses: '202': description: Accepted