diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml
index be7b0b4c..049a96c9 100644
--- a/descriptions/0/api.intercom.io.yaml
+++ b/descriptions/0/api.intercom.io.yaml
@@ -37326,13 +37326,25 @@ components:
             id:
               type: string
               description: The identifier for the contact which is given by Intercom.
-              format: uuid
+                Provide one of `id`, `user_id` or `email`. If you send more than one,
+                `id` is used first, then `user_id`.
               minLength: 24
               maxLength: 24
               example: 536e564f316c83104c000020
+            user_id:
+              type: string
+              description: The external identifier you gave the user. Matches users only;
+                for a lead, use `id` or `email`.
+              example: '25'
+            email:
+              type: string
+              description: The contact's email. Matches a user or a lead, depending on
+                `type`. Used only when `user_id` isn't sent. If several leads share the
+                email and it's the only identifier sent, the request fails with
+                `multiple_users`; use `id` instead.
+              example: joe@example.com
           required:
           - type
-          - id
         body:
           type: string
           description: The content of the message. HTML is not supported.
diff --git a/descriptions/2.17/api.intercom.io.yaml b/descriptions/2.17/api.intercom.io.yaml
index dce133b3..1a55a6d7 100644
--- a/descriptions/2.17/api.intercom.io.yaml
+++ b/descriptions/2.17/api.intercom.io.yaml
@@ -32821,13 +32821,25 @@ components:
             id:
               type: string
               description: The identifier for the contact which is given by Intercom.
-              format: uuid
+                Provide one of `id`, `user_id` or `email`. If you send more than one,
+                `id` is used first, then `user_id`.
               minLength: 24
               maxLength: 24
               example: 536e564f316c83104c000020
+            user_id:
+              type: string
+              description: The external identifier you gave the user. Matches users only;
+                for a lead, use `id` or `email`.
+              example: '25'
+            email:
+              type: string
+              description: The contact's email. Matches a user or a lead, depending on
+                `type`. Used only when `user_id` isn't sent. If several leads share the
+                email and it's the only identifier sent, the request fails with
+                `multiple_users`; use `id` instead.
+              example: joe@example.com
           required:
           - type
-          - id
         body:
           type: string
           description: The content of the message. HTML is not supported.