> ## Documentation Index
> Fetch the complete documentation index at: https://studio.assembly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a note

> Creates an internal note attached to a client or company. Requires title, entityId, and entityType; content is optional. Only internal users with sufficient privileges can create notes.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/notes
openapi: 3.0.0
info:
  contact: {}
  title: Assembly API
  version: 0.0.1
servers:
  - url: https://api.assembly.com
security: []
paths:
  /v1/notes:
    post:
      tags:
        - Notes
      summary: Create a note
      description: >-
        Creates an internal note attached to a client or company. Requires
        title, entityId, and entityType; content is optional. Only internal
        users with sufficient privileges can create notes.
      operationId: create-note
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_notes.CreateNoteHandlerInput'
        description: Note to create
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internal_notes.Note'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Invalid request body, content too long, or invalid entity type/ID
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Missing or invalid API key, or caller lacks access to the entity
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Unexpected server error
      security:
        - APIKeyHeader: []
components:
  schemas:
    internal_notes.CreateNoteHandlerInput:
      properties:
        content:
          description: >-
            Content is the body of the note. Optional; a note may have a title
            only.
          example: Discussed the rollout timeline and next steps.
          type: string
        entityId:
          description: >-
            ForeignKeyId is the ID of the client or company to attach the note
            to.
          example: f47ac10b-58cc-4372-a567-0e02b2c3d479
          type: string
        entityType:
          description: ForeignKeyType is the kind of entity to attach the note to.
          enum:
            - client
            - company
          example: client
          type: string
        title:
          description: Title is the short heading of the note.
          example: Onboarding call summary
          type: string
      required:
        - entityId
        - entityType
        - title
      type: object
    internal_notes.Note:
      properties:
        content:
          description: Content is the body of the note.
          example: Discussed the rollout timeline and next steps.
          type: string
        createdAt:
          type: string
        creatorId:
          description: >-
            CreatorId is the ID of the internal user who created the note.

            TODO(@foley): Let's remove this and use CreatedBy from Model, we'll
            need
                          to do some backward compatibility work for the platform API.
          example: 7b1c5d9e-2f34-4a8b-9c0d-1e2f3a4b5c6d
          type: string
        data:
          type: string
        entityId:
          description: >-
            ForeignKeyId is the ID of the client or company the note is attached
            to.
          example: f47ac10b-58cc-4372-a567-0e02b2c3d479
          type: string
        entityType:
          description: ForeignKeyType is the kind of entity the note is attached to.
          enum:
            - client
            - company
          example: client
          type: string
        id:
          type: string
        identityId:
          type: string
        object:
          type: string
        portalId:
          description: PortalID is the workspace the note belongs to.
          example: a1b2c3d4-5678-90ab-cdef-1234567890ab
          type: string
        previousAttributes:
          additionalProperties: true
          type: object
        ref:
          type: string
        title:
          description: Title is the short heading of the note.
          example: Onboarding call summary
          type: string
        updatedAt:
          type: string
      type: object
    dispatcher.Error:
      properties:
        code:
          type: string
        data: {}
        message:
          type: string
      type: object
  securitySchemes:
    APIKeyHeader:
      in: header
      name: X-API-KEY
      type: apiKey

````