Skip to main content
PUT
Write the note your workspace keeps on a person. There is one per person, whether they are a connector, a prospect or both, and any member can edit it. It shows on the person’s page and when someone requests an intro through them.
A write replaces the note. To add a line, read it with Get Person Note and send the combined text.
The person must be one of your connectors or appear in one of your warm intros; anyone else answers 404. An empty or whitespace-only body clears the note, exactly as Clear Person Note does; a missing body is a 400, so a request that forgot the field cannot wipe the note. Any member of the workspace can edit the note, which lives in Clustr only.

Authorizations

Authorization
string
header
required

The API key you created on the API settings page of the Clustr app.

Path Parameters

person_id
string
required

The person's Clustr ID (per_…), as List Connectors and the person record return it. The ID of a person since merged into another answers for that person.

Body

application/json
body
string
required

The note. Surrounding whitespace is trimmed. An empty or whitespace-only body clears the note, as DELETE does.

Maximum string length: 10000

Response

The stored note

success
boolean
data
object