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

# Add Prospect Note Fact

> Adds a fact to a real LEAD prospect's relationship note. Assembled text above 1800 characters is compacted once; the returned text is saved unchanged. Existing campaign permissions apply; drafts and automation state are unchanged.



## OpenAPI

````yaml https://api.goextrovert.com/client/v2/docs-json post /client/v2/prospects/{id}/add-note-fact
openapi: 3.1.0
info:
  title: Extrovert Client API
  description: >-
    Public API for Extrovert platform integration. Use your API key for
    authentication.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.goextrovert.com/
    description: API Server
security: []
tags: []
paths:
  /client/v2/prospects/{id}/add-note-fact:
    post:
      tags:
        - Prospects
      summary: Add Prospect Note Fact
      description: >-
        Adds a fact to a real LEAD prospect's relationship note. Assembled text
        above 1800 characters is compacted once; the returned text is saved
        unchanged. Existing campaign permissions apply; drafts and automation
        state are unchanged.
      operationId: ProspectsClientApiController_addNoteFact
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddNoteFactBodyPublicApiDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddNoteFactResponseDto'
        '401':
          description: Invalid or missing API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClientApiErrorResponseDto'
      security:
        - api-key: []
components:
  schemas:
    AddNoteFactBodyPublicApiDto:
      type: object
      properties:
        fact:
          type: string
          description: >-
            Relationship fact to add, without normalization or a manual-note
            length limit.
      required:
        - fact
    AddNoteFactResponseDto:
      type: object
      properties:
        status:
          type: string
          const: success
          description: Response status
        data:
          type: object
          properties:
            id:
              type: string
              format: uuid
              description: Prospect id
              examples:
                - 8d256aa6-9b12-49a7-93ee-bf41634b5b60
            updatedAt:
              type: string
              description: Prospect update timestamp
              examples:
                - '2025-06-30T14:02:07.456Z'
                - '2025-07-03T08:30:00.000Z'
            createdAt:
              type: string
              description: Prospect creation timestamp
              examples:
                - '2025-06-30T14:02:07.456Z'
                - '2025-07-03T08:30:00.000Z'
            linkedInProfile:
              description: LinkedIn profile details, if available
              type: object
              properties:
                id:
                  type: string
                  description: LinkedIn profile entity id
                updatedAt:
                  type: string
                  description: LinkedIn profile update timestamp
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                createdAt:
                  type: string
                  description: LinkedIn profile creation timestamp
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                name:
                  type: string
                  description: Prospect full name from LinkedIn
                headline:
                  type: string
                  description: Prospect LinkedIn headline
                avatarUrl:
                  description: Avatar image URL, if available
                  type: string
                linkedInUrl:
                  type: string
                  description: Public LinkedIn profile URL
              required:
                - id
                - updatedAt
                - createdAt
                - name
                - headline
                - linkedInUrl
            list:
              description: >-
                Reference to the prospect list this prospect currently belongs
                to — `id` plus `name`.
              type: object
              properties:
                id:
                  type: string
                  format: uuid
                  description: Stable Extrovert entity ID.
                  examples:
                    - 8d256aa6-9b12-49a7-93ee-bf41634b5b60
                name:
                  type: string
                  description: Customer-facing entity name.
                description:
                  description: Optional extra description, if available
                  type: string
              required:
                - id
                - name
            lastNewPostsObtainFinishDate:
              description: Latest new-post fetch finish date, if available
              type: string
              examples:
                - '2025-06-30T14:02:07.456Z'
                - '2025-07-03T08:30:00.000Z'
            lastPostsFetchStatus:
              type: string
              description: >-
                Status of the last attempt to fetch new posts for this prospect,
                an open string. Current states: `waiting_for_initialization`,
                `requested`, `success`, `target_user_not_found`,
                `unknown_error`, `crashed_or_cancelled`. A successful collection
                may find no new posts; `target_user_not_found` does not prove
                the profile was deleted. Use together with
                `lastNewPostsObtainFinishDate` to gauge fetch health.
            isDeleted:
              type: boolean
              description: Whether the prospect is deleted
            isImportant:
              type: boolean
              description: Whether the prospect is marked as important
            notes:
              description: >-
                Owner-specific relationship context of this persisted LEAD
                prospect, when present.
              type: string
            type:
              type: string
              description: >-
                Prospect kind. `LEAD` — a prospect the user added to engage with
                directly; `RECENTLY_LIKED_RELATED_USER` — an indirect prospect
                (someone the LEAD recently engaged with), surfaced by the
                indirect-engagement feature when the campaign's
                `commenting.indirectCommentingEnabled` is on. Drives which
                actions are available on the prospect.
            parentTargetUser:
              description: >-
                For indirect prospects (`type === RECENTLY_LIKED_RELATED_USER`):
                flat reference to the original LEAD, including its relationship
                note when present. Fetch the full parent record separately by
                its `id`. Missing for direct LEADs.
              type: object
              properties:
                id:
                  type: string
                  format: uuid
                  description: Parent prospect id
                notes:
                  description: >-
                    Relationship context of the parent LEAD prospect, when
                    present.
                  type: string
                type:
                  type: string
                  description: >-
                    Parent prospect kind — same value space as the top-level
                    `type` field.
                linkedInProfile:
                  description: LinkedIn profile of the parent prospect, if available
                  type: object
                  properties:
                    id:
                      type: string
                      description: LinkedIn profile entity id
                    updatedAt:
                      type: string
                      description: LinkedIn profile update timestamp
                      examples:
                        - '2025-06-30T14:02:07.456Z'
                        - '2025-07-03T08:30:00.000Z'
                    createdAt:
                      type: string
                      description: LinkedIn profile creation timestamp
                      examples:
                        - '2025-06-30T14:02:07.456Z'
                        - '2025-07-03T08:30:00.000Z'
                    name:
                      type: string
                      description: Prospect full name from LinkedIn
                    headline:
                      type: string
                      description: Prospect LinkedIn headline
                    avatarUrl:
                      description: Avatar image URL, if available
                      type: string
                    linkedInUrl:
                      type: string
                      description: Public LinkedIn profile URL
                  required:
                    - id
                    - updatedAt
                    - createdAt
                    - name
                    - headline
                    - linkedInUrl
              required:
                - id
                - type
            statistics:
              description: Lightweight engagement statistics, if available
              type: object
              properties:
                totalPostsCount:
                  type: number
                  description: >-
                    Total direct posts (posts the prospect authored themselves)
                    fetched so far.
                oldestPostDate:
                  description: Oldest fetched direct post date, if available.
                  type: string
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                newestPostDate:
                  description: Newest fetched direct post date, if available.
                  type: string
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                answeredPostsCount:
                  type: number
                  description: >-
                    Number of direct comments already posted by the campaign
                    owner under the prospect's own posts.
                pendingPostsAnswersCount:
                  type: number
                  description: >-
                    Number of direct comments approved and queued to be posted
                    to LinkedIn (not yet sent).
                oldestPostAnswerDate:
                  description: Oldest direct comment date, if any.
                  type: string
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                newestPostAnswerDate:
                  description: Newest direct comment date, if any.
                  type: string
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                postsLikesCount:
                  type: number
                  description: Likes the campaign owner placed on the prospect's own posts.
                weeklyPostFrequency:
                  type: number
                  description: >-
                    Average weekly posting frequency of the prospect (their own
                    posts).
                lastNewSuccessPostsObtainFinishDate:
                  description: Last successful post sync finish date, if any.
                  type: string
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                indirectPostsLikesCount:
                  type: number
                  description: >-
                    Likes the campaign owner placed on indirect posts (posts
                    from people the prospect engages with).
                indirectOldestResponseCommentDate:
                  description: >-
                    Oldest indirect-comment date (comment under an indirect
                    post), if any.
                  type: string
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                indirectNewestResponseCommentDate:
                  description: >-
                    Newest indirect-comment date (comment under an indirect
                    post), if any.
                  type: string
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                indirectAnsweredPostsCount:
                  type: number
                  description: >-
                    Number of indirect comments already posted (comments under
                    indirect posts).
                indirectPendingResponseCommentsCount:
                  type: number
                  description: >-
                    Number of indirect comments approved and queued to be posted
                    to LinkedIn (not yet sent).
                lastNewSuccessPostsTotalCount:
                  type: number
                  description: >-
                    Number of new posts fetched during the last successful
                    post-fetch run.
                totalIndirectPostActivitiesCount:
                  type: number
                  description: >-
                    Total indirect posts (posts from people the prospect engages
                    with) fetched so far.
                weeklyIndirectPostActivityFrequency:
                  type: number
                  description: Average weekly frequency of indirect post activities.
                newestPostReactionDate:
                  description: >-
                    Newest date of any reaction/like by the prospect on a post,
                    if any.
                  type: string
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                totalAnsweredPostsCount:
                  type: number
                  description: >-
                    Total comments already posted by the campaign owner (direct
                    + indirect).
                totalOldestResponseCommentDate:
                  description: >-
                    Oldest comment date across all activity (direct + indirect),
                    if any.
                  type: string
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                totalNewestResponseCommentDate:
                  description: >-
                    Newest comment date across all activity (direct + indirect),
                    if any.
                  type: string
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
              required:
                - totalPostsCount
                - answeredPostsCount
                - pendingPostsAnswersCount
                - postsLikesCount
                - weeklyPostFrequency
                - indirectPostsLikesCount
                - indirectAnsweredPostsCount
                - indirectPendingResponseCommentsCount
                - lastNewSuccessPostsTotalCount
                - totalIndirectPostActivitiesCount
                - weeklyIndirectPostActivityFrequency
                - totalAnsweredPostsCount
            campaign:
              description: Reference to the parent campaign — `id` plus `name`.
              type: object
              properties:
                id:
                  type: string
                  format: uuid
                  description: Stable Extrovert entity ID.
                  examples:
                    - 8d256aa6-9b12-49a7-93ee-bf41634b5b60
                name:
                  type: string
                  description: Customer-facing entity name.
                description:
                  description: Optional extra description, if available
                  type: string
              required:
                - id
                - name
            sharedBy:
              description: Team member who shared this prospect, if applicable
              type: object
              properties:
                id:
                  type: string
                  format: uuid
                  description: Stable Extrovert entity ID.
                  examples:
                    - 8d256aa6-9b12-49a7-93ee-bf41634b5b60
                name:
                  type: string
                  description: Customer-facing entity name.
                description:
                  description: Optional extra description, if available
                  type: string
              required:
                - id
                - name
            user:
              description: >-
                Reference to the user who owns this prospect — `id` plus `name`.
                Missing if not available.
              type: object
              properties:
                id:
                  type: string
                  format: uuid
                  description: Stable Extrovert entity ID.
                  examples:
                    - 8d256aa6-9b12-49a7-93ee-bf41634b5b60
                name:
                  type: string
                  description: Customer-facing entity name.
                description:
                  description: Optional extra description, if available
                  type: string
              required:
                - id
                - name
            userConnection:
              description: LinkedIn connection data, if available
              type: object
              properties:
                id:
                  type: string
                  description: Connection entity id
                updatedAt:
                  type: string
                  description: Connection update timestamp
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                createdAt:
                  type: string
                  description: Connection creation timestamp
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                userId:
                  type: string
                  format: uuid
                  description: Team member id that owns the connection
                prospectLinkedInProfileId:
                  type: string
                  description: LinkedIn profile id for the prospect
                status:
                  type: string
                  description: Current connection status
                connectedDate:
                  description: Date when the connection was established, if available
                  type: string
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                wasConnectionRequestSuccessfulAttemptMade:
                  type: boolean
                  description: >-
                    Whether Extrovert has successfully sent a connection request
                    to this prospect. If `false` and `status` is `CONNECTED`,
                    the connection was already in place before Extrovert started
                    tracking it.
                connectionRequestSuccessfulAttemptMadeDate:
                  description: >-
                    Date when Extrovert successfully sent the connection
                    request, if any.
                  type: string
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
                latestDmHistoryMessageDate:
                  description: Latest synced DM history message date, if available
                  type: string
                  examples:
                    - '2025-06-30T14:02:07.456Z'
                    - '2025-07-03T08:30:00.000Z'
              required:
                - id
                - updatedAt
                - createdAt
                - userId
                - prospectLinkedInProfileId
                - status
                - wasConnectionRequestSuccessfulAttemptMade
          required:
            - id
            - updatedAt
            - createdAt
            - lastPostsFetchStatus
            - isDeleted
            - isImportant
            - type
        message:
          type: string
          description: Success message
          examples:
            - Operation completed successfully
      required:
        - status
        - data
        - message
    ClientApiErrorResponseDto:
      type: object
      properties:
        status:
          type: string
          description: Response status
          example: error
          enum:
            - error
        data:
          type: 'null'
          description: Response data
          example: null
        message:
          type: string
          description: Error message
          example: An error occurred while processing the request
      required:
        - status
        - data
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-Key
      description: API Key for authentication

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.