Adding to, cc and bcc to docs

Author: eoghan-murphy-intercom

descriptions/0/api.intercom.io.yaml

@@ -8887,8 +8887,17 @@ paths:
                     type: admin
                     id: '991267816'
                   to:
-                    type: user
-                    id: 6762f2391bb69f9f2193bc19
+                    - type: user
+                      id: 6762f2391bb69f9f2193bc19
+                    - type: lead
+                      id: 6762f23c1bb69f9f2193bc1b
+                    - type: user
+                      id: 6762f23d1bb69f9f2193bc1c
+                  cc:
+                    - type: user
+                      id: 6762f23e1bb69f9f2193bc1d
+                    - type: user
+                      id: 6762f23f1bb69f9f2193bc1e
                   message_type: conversation
                   body: heyy
               admin_sms_message_created:
@@ -16271,24 +16280,35 @@ components:
           - type
           - id
         to:
-          type: object
-          description: The sender of the message. If not provided, the default sender
-            will be used.
-          properties:
-            type:
-              type: string
-              description: The role associated to the contact - `user` or `lead`.
-              enum:
-              - user
-              - lead
-              example: user
-            id:
-              type: string
-              description: The identifier for the contact which is given by Intercom.
-              example: 536e564f316c83104c000020
-          required:
-          - type
-          - id
+          oneOf:
+            - $ref: '#/components/schemas/recipient'
+            - type: array
+              description: The recipients of the message.
+              items:
+                $ref: '#/components/schemas/recipient'
+              example:
+                - type: user
+                  id: 536e564f316c83104c000020
+                - type: lead
+                  id: 536e564f316c83104c000021
+        cc:
+          oneOf:
+            - $ref: '#/components/schemas/recipient'
+            - type: array
+              description: The CC recipients of the message.
+              items:
+                $ref: '#/components/schemas/recipient'
+              example:
+                - type: user
+                  id: 536e564f316c83104c000023
+        bcc:
+          type: array
+          description: The BCC recipients of the message.
+          items:
+            $ref: '#/components/schemas/recipient'
+          example:
+            - type: user
+              id: 536e564f316c83104c000022
         created_at:
           type: integer
           description: The time the message was created. If not provided, the current
@@ -16321,6 +16341,25 @@ components:
         - body
         - from
         - to
+    recipient:
+      type: object
+      title: Recipient
+      description: A recipient of a message
+      properties:
+        type:
+          type: string
+          description: The role associated to the contact - `user` or `lead`.
+          enum:
+          - user
+          - lead
+          example: user
+        id:
+          type: string
+          description: The identifier for the contact which is given by Intercom.
+          example: 536e564f316c83104c000020
+      required:
+      - type
+      - id
     create_or_update_company_request:
       type: object
       title: Create Or Update Company Request Payload