Add channel field to ticket creation endpoints from v2.14

Document the optional `channel` field on the Create Ticket endpoint,
available from API version 2.14 (AllowChannelToTicket). Request accepts
`email` only (SUPPORTED_CHANNELS); the ticket response channel reflects
the conversation's initial channel. Added to the create ticket request
and ticket response schemas and the request examples across 2.14, 2.15,
2.16 and 0 (Preview).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: VarshSuresh

descriptions/0/api.intercom.io.yaml

@@ -25891,6 +25891,7 @@ paths:
                       has_more: false
                     category: Back-office
                     is_shared: false
+                    channel: email
               schema:
                 "$ref": "#/components/schemas/ticket"
         '401':
@@ -25928,6 +25929,7 @@ paths:
                   ticket_attributes:
                     _default_title_: example
                     _default_description_: there is a problem
+                  channel: email
   "/tickets/enqueue":
     post:
       summary: Enqueue create ticket
@@ -25961,6 +25963,7 @@ paths:
                   ticket_attributes:
                     _default_title_: example
                     _default_description_: there is a problem
+                  channel: email
       responses:
         '200':
           description: Successful response
@@ -37195,6 +37198,12 @@ components:
               description: The ID of the team to which the ticket is assigned.
                 If not provided, the ticket will be unassigned.
               example: '8'
+        channel:
+          type: string
+          description: The channel for the ticket. Only supported for customer ticket types. Defaults to messenger if not provided.
+          enum:
+          - email
+          example: email
       required:
       - ticket_type_id
       - contacts
@@ -44053,6 +44062,13 @@ components:
           - Back-office
           - Tracker
           example: Customer
+        channel:
+          type: string
+          description: The channel for the ticket. Only supported for customer ticket types.
+          enum:
+          - email
+          - messenger
+          example: messenger
         ticket_attributes:
           "$ref": "#/components/schemas/ticket_custom_attributes"
         ticket_state:

descriptions/2.14/api.intercom.io.yaml

@@ -14107,6 +14107,7 @@ paths:
                   ticket_attributes:
                     _default_title_: example
                     _default_description_: there is a problem
+                  channel: email
   "/tickets/enqueue":
     post:
       summary: Enqueue create ticket
@@ -14140,6 +14141,7 @@ paths:
                   ticket_attributes:
                     _default_title_: example
                     _default_description_: there is a problem
+                  channel: email
       responses:
         '200':
           description: Successful response
@@ -14619,6 +14621,7 @@ paths:
                       has_more: false
                     category: Back-office
                     is_shared: false
+                    channel: email
               schema:
                 "$ref": "#/components/schemas/ticket"
         '401':
@@ -19570,6 +19573,12 @@ components:
               description: The ID of the team to which the ticket is assigned.
                 If not provided, the ticket will be unassigned.
               example: '8'
+        channel:
+          type: string
+          description: The channel for the ticket. Only supported for customer ticket types. Defaults to messenger if not provided.
+          enum:
+          - email
+          example: email
       required:
       - ticket_type_id
       - contacts
@@ -22777,6 +22786,13 @@ components:
           - Back-office
           - Tracker
           example: Customer
+        channel:
+          type: string
+          description: The channel for the ticket. Only supported for customer ticket types.
+          enum:
+          - email
+          - messenger
+          example: messenger
         ticket_attributes:
           "$ref": "#/components/schemas/ticket_custom_attributes"
         ticket_state:

descriptions/2.15/api.intercom.io.yaml

@@ -13398,6 +13398,7 @@ paths:
                   ticket_attributes:
                     _default_title_: example
                     _default_description_: there is a problem
+                  channel: email
   "/tickets/enqueue":
     post:
       summary: Enqueue create ticket
@@ -13431,6 +13432,7 @@ paths:
                   ticket_attributes:
                     _default_title_: example
                     _default_description_: there is a problem
+                  channel: email
       responses:
         '200':
           description: Successful response
@@ -13910,6 +13912,7 @@ paths:
                       has_more: false
                     category: Back-office
                     is_shared: false
+                    channel: email
               schema:
                 "$ref": "#/components/schemas/ticket"
         '401':
@@ -20382,6 +20385,12 @@ components:
               description: The ID of the team to which the ticket is assigned.
                 If not provided, the ticket will be unassigned.
               example: '8'
+        channel:
+          type: string
+          description: The channel for the ticket. Only supported for customer ticket types. Defaults to messenger if not provided.
+          enum:
+          - email
+          example: email
       required:
       - ticket_type_id
       - contacts
@@ -23786,6 +23795,13 @@ components:
           - Back-office
           - Tracker
           example: Customer
+        channel:
+          type: string
+          description: The channel for the ticket. Only supported for customer ticket types.
+          enum:
+          - email
+          - messenger
+          example: messenger
         ticket_attributes:
           "$ref": "#/components/schemas/ticket_custom_attributes"
         ticket_state:

descriptions/2.16/api.intercom.io.yaml

@@ -21076,6 +21076,7 @@ paths:
                   ticket_attributes:
                     _default_title_: example
                     _default_description_: there is a problem
+                  channel: email
   "/tickets/enqueue":
     post:
       summary: Enqueue create ticket
@@ -21109,6 +21110,7 @@ paths:
                   ticket_attributes:
                     _default_title_: example
                     _default_description_: there is a problem
+                  channel: email
       responses:
         '200':
           description: Successful response
@@ -21588,6 +21590,7 @@ paths:
                       has_more: false
                     category: Back-office
                     is_shared: false
+                    channel: email
               schema:
                 "$ref": "#/components/schemas/ticket"
         '401':
@@ -29649,6 +29652,12 @@ components:
               description: The ID of the team to which the ticket is assigned.
                 If not provided, the ticket will be unassigned.
               example: '8'
+        channel:
+          type: string
+          description: The channel for the ticket. Only supported for customer ticket types. Defaults to messenger if not provided.
+          enum:
+          - email
+          example: email
       required:
       - ticket_type_id
       - contacts
@@ -34674,6 +34683,13 @@ components:
           - Back-office
           - Tracker
           example: Customer
+        channel:
+          type: string
+          description: The channel for the ticket. Only supported for customer ticket types.
+          enum:
+          - email
+          - messenger
+          example: messenger
         ticket_attributes:
           "$ref": "#/components/schemas/ticket_custom_attributes"
         ticket_state: