Skip to main content
POST
Create a note

Authorizations

Authorization
string
header
required

A workspace API token (sk_live_...) or an OAuth access token (oat_live_...). Create workspace tokens in Settings > API. Send either as Authorization: Bearer <token>.

Headers

Idempotency-Key
string

A unique value (a UUID works) that makes retrying this request safe. A repeat with the same key and body within 24 hours returns the original response instead of acting twice; the same key with a different body is a 409 idempotency_key_reused.

Maximum string length: 255

Body

application/json

Body for POST /v1/notes.

content
string
required
Required string length: 1 - 100000
record_id
string
required

Id of a contact, organization or deal. The prefix names the kind of record.

Pattern: ^(con|org|deal)_[0-9a-f]{32}$
Example:

"con_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4"

Response

Successful Response

A free-text note on a contact, organization or deal.

content
string
required
created_at
string<date-time>
required
id
string
required

Unique identifier for a note.

Pattern: ^note_[0-9a-f]{32}$
Example:

"note_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4"

record_id
string
required

The record this note was written on. A note on a deal also appears when listing the notes of that deal's contact and organization.

Pattern: ^(con|org|deal)_[0-9a-f]{32}$
Example:

"con_9f2ac41d8b7e4a51b0d3e6f7a1c2d3e4"

updated_at
string<date-time>
required
author
Owner · object | null

Who wrote it — a teammate or an AI agent. Null for notes created by an integration or imported in bulk.

object
string
default:note
Allowed value: "note"