---
title: "Create a Portfolio Note"
method: POST
path: "/portfolio_notes"
tags: ["Portfolio Notes"]
---

# Create a Portfolio Note

`POST /portfolio_notes`

Creates a portfolio note for a portfolio company profile.

Public API clients must send plaintext or markdown content as a string.

## Request body

- object
  - `portfolio_note` PortfolioNoteInput
    - `name` string, required — Name/title of the portfolio note
    - `content` string, required — Plaintext or markdown portfolio note content as a string.
    - `portfolio_company_profile_id` string, uuid, required — ID of the portfolio company profile to attach the note to

## Response `201`

Portfolio note successfully created

- object
  - `portfolio_note` PortfolioNote
    - `id` string, uuid, required — Unique identifier for the portfolio note
    - `name` string, required — Name/title of the portfolio note
    - `portfolio_company_profile_id` string, uuid, required — ID of the associated portfolio company profile
    - `content` string, nullable, required — Content of the portfolio note. May be null immediately after create while asynchronous processing completes.
    - `created_at` string, date-time — When the portfolio note was created

## Other responses

- `400` — Bad Request - The request is invalid or malformed
- `401` — Unauthorized - Invalid or missing authentication token
- `403` — Forbidden - The authenticated user does not have access to the requested resource
- `422` — Unprocessable Entity - The request is valid but contains semantic errors
- `429` — Too Many Requests - Rate limit exceeded

---

[API](https://skmtc.dev/visible/apis/visible-api.md) · [All operations](https://skmtc.dev/visible/apis/visible-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/visible/visible-api/revisions/a04e0975020f/schema)