Add POST /companies/{id}/notes endpoint to OpenAPI spec (Unstable)

[efassor]

Why?

PR #470943 added the ability to create notes on company records via the API, but the OpenAPI specification wasn't updated. Developers need the OpenAPI documentation to discover and use this new endpoint, and downstream tools/SDKs rely on the spec for code generation.

How?

Added the POST endpoint to the Unstable version (descriptions/0/api.intercom.io.yaml) following the same pattern as the existing POST /contacts/{id}/notes endpoint, with company-specific adaptations (UUID string IDs instead of integer IDs).

Implementation Details

Endpoint: POST /companies/{id}/notes
Operation ID: createCompanyNote
Tags: Notes, Companies

Key differences from contact notes:

• Company IDs are type: string (UUIDs) vs contact IDs which are type: integer
• Request body uses company_id instead of contact_id
• Response includes company object instead of contact object
• Error messages reference "Company Not Found"

Request Body:

• body (string, required): The note text
• company_id (string): Company UUID
• admin_id (string): Admin ID (defaults to token owner if not provided)

Responses:

• 200: Returns note object with company reference
• 404: Company not found or admin not found

OAuth Scope: post_companies_list

_{Generated with Claude Code}