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

# Create a conversation note event.

> Creates a note event on a conversation so users can document lead context, handoffs, and follow-up details.



## OpenAPI

````yaml /openapi.json post /events/conversations/{conversationId}/notes
openapi: 3.0.4
info:
  title: Leadping API
  description: >-
    Leadping API for lead intake, messaging, calling, automations, billing,
    business settings, and compliant lead communication workflows.
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  version: v1
servers:
  - url: https://api.leadping.ai
    description: Production
security: []
tags:
  - name: Analytics
  - name: Automations
  - name: Contact
  - name: Conversations
  - name: Dispositions
  - name: Feedback
  - name: Leads
  - name: LeadStatuses
  - name: Notifications
  - name: OutboundDelivery
  - name: Sources
  - name: Suppressions
  - name: Tags
  - name: Users
  - name: Calls
  - name: PhoneNumbers
  - name: Sms
  - name: Telephony
  - name: UserDataExports
  - name: CallEvents
  - name: Events
  - name: SmsEvents
  - name: Businesses
  - name: PaymentMethods
  - name: Transactions
  - name: Usage
  - name: Wallets
paths:
  /events/conversations/{conversationId}/notes:
    post:
      tags:
        - Events
      summary: Create a conversation note event.
      description: >-
        Creates a note event on a conversation so users can document lead
        context, handoffs, and follow-up details.
      operationId: Events_CreateNote
      parameters:
        - name: conversationId
          in: path
          description: The conversation identifier.
          required: true
          schema:
            type: string
      requestBody:
        description: The create note request payload for the operation.
        content:
          application/json:
            schema:
              allOf:
                - $ref: '#/components/schemas/CreateNoteRequest'
              description: Request payload for create note.
          application/*+json:
            schema:
              allOf:
                - $ref: '#/components/schemas/CreateNoteRequest'
              description: Request payload for create note.
        required: true
      responses:
        '200':
          description: Returns the event table row.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/EventTableRow'
                description: >-
                  List item schema for Leadping API event timeline table row
                  results shown in searchable tables.
        '400':
          description: The request was invalid or failed validation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
components:
  schemas:
    CreateNoteRequest:
      type: object
      properties:
        text:
          type: string
          description: The text value for this note.
      description: Request payload for create note.
    EventTableRow:
      type: object
      properties:
        id:
          type: string
          description: Unique Leadping identifier for this event timeline table row.
        eventType:
          type: string
          description: >-
            Event type used to classify this timeline, SMS, call, or automation
            event.
        eventCategory:
          type: string
          description: High-level category used to group this Leadping event.
          nullable: true
        timelineType:
          allOf:
            - $ref: '#/components/schemas/EventTimelineType'
          description: Timeline type used to render this event in Leadping activity feeds.
        timelineCategory:
          type: string
          description: Timeline category used to group events for display and filtering.
        description:
          type: string
          description: >-
            Human-readable description that explains this event timeline table
            row to API users.
        conversationId:
          type: string
          description: >-
            Conversation ID that links this event timeline table row to the
            Leadping inbox thread.
          nullable: true
        leadId:
          type: string
          description: Lead ID associated with this timeline event.
          nullable: true
        relatedEntityType:
          type: string
          description: Related entity type connected to this event or notification.
          nullable: true
        relatedEntityId:
          type: string
          description: Related entity ID connected to this event or notification.
          nullable: true
        summary:
          type: string
          description: >-
            Short human-readable summary of this event timeline table row for
            lists, timelines, and notifications.
          nullable: true
        direction:
          type: string
          description: >-
            Communication direction for this event timeline table row, such as
            inbound or outbound.
          nullable: true
        status:
          enum:
            - Pending
            - InProgress
            - Completed
            - Cancelled
            - Scheduled
            - Queued
            - Sending
            - Sent
            - Received
            - Delivered
            - Undeliverable
            - Opted out
            - Blocked
            - Initiated
            - Ringing
            - Active
            - Ended
            - Missed
            - Voicemail
            - Failed
            - Canceled
          type: string
          description: Defines the supported Event timeline status values.
          nullable: true
        statusReason:
          type: string
          description: >-
            Human-readable reason explaining the current status of this event
            timeline table row.
          nullable: true
        trafficType:
          enum:
            - RealLead
            - Warmup
            - Test
            - SystemInternal
            - FailedAttempt
          type: string
          description: Defines the supported SMS Traffic Type values.
          nullable: true
        fromPhoneNumberId:
          type: string
          description: Sender phone number ID used for this outbound SMS or call.
          nullable: true
        outboundPhoneNumberId:
          type: string
          description: Phone number ID selected for outbound delivery.
          nullable: true
        fromPhoneNumber:
          type: string
          description: Sender phone number used for this communication.
          nullable: true
        toPhoneNumber:
          type: string
          description: Recipient phone number used for this communication.
          nullable: true
        selectionReason:
          enum:
            - StickyConversation
            - LeadAssigned
            - CampaignOrSource
            - Preferred
            - LocalArea
            - HealthyPool
            - FallbackDefault
            - ManualOverride
          type: string
          description: Defines the supported Outgoing Number Selection Reason values.
          nullable: true
        wasManuallyOverridden:
          type: boolean
          description: >-
            Indicates whether a user manually overrode Leadping's automatic
            number selection for this event timeline table row.
        campaignId:
          type: string
          description: >-
            Messaging campaign identifier associated with this event timeline
            table row.
          nullable: true
        sourceId:
          type: string
          description: Lead source ID used for event attribution.
          nullable: true
        complianceAction:
          type: string
          description: Compliance action applied to this message, lead, or sender.
          nullable: true
        billingStatus:
          type: string
          description: Billing state for this communication, charge, or transaction.
          nullable: true
        billableAmount:
          pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$
          description: >-
            Monetary amount billed for this Leadping communication or
            transaction.
          format: double
          nullable: true
        errorCode:
          type: string
          description: >-
            Machine-readable error code returned while processing this event
            timeline table row.
          nullable: true
        retryCount:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            Number of retry attempts already made for this event timeline table
            row.
          format: int32
        queuedAt:
          type: string
          description: >-
            UTC timestamp when Leadping queued this event timeline table row for
            processing.
          format: date-time
          nullable: true
        sendingStartedAt:
          type: string
          description: UTC timestamp when Leadping began sending this message.
          format: date-time
          nullable: true
        sentAt:
          type: string
          description: UTC timestamp when Leadping sent this message to the provider.
          format: date-time
          nullable: true
        deliveredAt:
          type: string
          description: UTC timestamp when the provider confirmed delivery.
          format: date-time
          nullable: true
        receivedAt:
          type: string
          description: UTC timestamp when Leadping received this inbound event or message.
          format: date-time
          nullable: true
        failedAt:
          type: string
          description: >-
            UTC timestamp when processing failed for this event timeline table
            row.
          format: date-time
          nullable: true
        undeliverableAt:
          type: string
          description: UTC timestamp when the provider marked the message undeliverable.
          format: date-time
          nullable: true
        blockedAt:
          type: string
          description: UTC timestamp when Leadping blocked this communication.
          format: date-time
          nullable: true
        nextRetryAt:
          type: string
          description: >-
            UTC timestamp when Leadping will retry this event timeline table
            row.
          format: date-time
          nullable: true
        scheduledFor:
          type: string
          description: >-
            UTC timestamp when the related delivery or workflow action is
            scheduled to run.
          format: date-time
          nullable: true
        scheduledReason:
          type: string
          description: Reason Leadping scheduled this delivery for a later time.
          nullable: true
        canceledAt:
          type: string
          description: UTC timestamp when this delivery or workflow was canceled.
          format: date-time
          nullable: true
        cancelReason:
          type: string
          description: Reason this delivery, run, or request was canceled.
          nullable: true
        createdAt:
          type: string
          description: UTC timestamp when this event timeline table row was created.
          format: date-time
        createdBy:
          type: string
          description: >-
            Display name or identifier for the person or system that created
            this event timeline table row.
        actorUserId:
          type: string
          description: >-
            User ID for the person or system that created this event timeline
            table row.
          nullable: true
        actorDisplayName:
          type: string
          description: >-
            Display name for the person or system that created this event
            timeline table row.
          nullable: true
        actorEmail:
          type: string
          description: >-
            Email address for the person who created this event timeline table
            row.
          nullable: true
      description: >-
        List item schema for Leadping API event timeline table row results shown
        in searchable tables.
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          description: URI reference that identifies the problem type.
          nullable: true
        title:
          type: string
          description: Short, human-readable summary of the problem.
          nullable: true
        status:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: HTTP status code returned for the problem.
          format: int32
          nullable: true
        detail:
          type: string
          description: >-
            Human-readable explanation specific to this occurrence of the
            problem.
          nullable: true
        instance:
          type: string
          description: >-
            URI reference that identifies this specific occurrence of the
            problem.
          nullable: true
    EventTimelineType:
      enum:
        - Message
        - Sms
        - Mms
        - Call
        - Voicemail
        - Note
        - Disposition
        - LeadCreated
        - LeadUpdated
        - Notification
        - Payment
        - Warmup
      type: string
      description: Defines the supported Event timeline type values.

````