Add notes field to company API responses

- Added notes field to company schema following the same pattern as contact_notes
- Updated example responses for POST /companies and GET /companies/{id} endpoints
- Notes field includes type, data array with addressable_list items, url, total_count, and has_more properties

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: markdennis22

descriptions/0/api.intercom.io.yaml

@@ -2680,6 +2680,12 @@ paths:
                     plan: {}
                     custom_attributes:
                       creation_source: api
+                    notes:
+                      type: note.list
+                      data: []
+                      url: "/companies/6762f0761bb69f9f2193bae2/notes"
+                      total_count: 0
+                      has_more: false
               schema:
                 "$ref": "#/components/schemas/company"
         '400':
@@ -2902,6 +2908,12 @@ paths:
                       segments: []
                     plan: {}
                     custom_attributes: {}
+                    notes:
+                      type: note.list
+                      data: []
+                      url: "/companies/6762f07f1bb69f9f2193baf5/notes"
+                      total_count: 0
+                      has_more: false
               schema:
                 "$ref": "#/components/schemas/company"
         '404':
@@ -16475,6 +16487,37 @@ components:
               type: array
               items:
                 "$ref": "#/components/schemas/segment"
+        notes:
+          type: object
+          nullable: false
+          description: An object containing notes meta data about the notes that a company
+            has. Up to 10 will be displayed here. Use the url to get more.
+          properties:
+            type:
+              type: string
+              description: The type of the object
+              enum:
+              - note.list
+            data:
+              type: array
+              description: This object represents the notes attached to a company.
+              items:
+                "$ref": "#/components/schemas/addressable_list"
+            url:
+              type: string
+              format: uri
+              description: Url to get more notes for this company
+              example: "/companies/68d659c788f929561ede8454/notes"
+            total_count:
+              type: integer
+              description: Int representing the total number of notes attached to
+                this company
+              example: 1
+            has_more:
+              type: boolean
+              description: Whether there's more notes to be viewed. If true,
+                use the url to view all
+              example: false
     company_attached_contacts:
       title: Company Attached Contacts
       type: object