---
title: "Create Internal Note Endpoint"
method: POST
path: "/v1/prospect/internal-note"
tags: ["Prospect"]
---

# Create Internal Note Endpoint

`POST /v1/prospect/internal-note`

Create an internal note on a prospect or resident conversation.

## Request body

- CreateInternalNoteRequest
  - `elise_prospect_id` string — Elise prospect ID. Provide exactly one of elise_prospect_id or elise_resident_id.
  - `elise_resident_id` integer — Elise resident ID. Provide exactly one of elise_prospect_id or elise_resident_id.
  - `note` string, required — Note body. Must be non-empty; max 2000 characters.
  - `user_id` string — Author user ID. If provided, the note is attributed to that user; if omitted, the note is marked as an external (vendor) note with no human author.
  - `vendor_name` string — Optional source label shown as the note's author in the conversation thread when no author user_id is provided (e.g. the vendor or system that created it).

## Response `201`

Successful Response

- CreateInternalNoteResponse
  - `note_id` integer, required

## Other responses

- `401` — Not Authorized for this endpoint
- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.net/eliseai/apis/elise-api.md) · [All operations](https://skmtc.net/eliseai/apis/elise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eliseai/elise-api/revisions/a75af086c674/schema)