Skip to main content
POST
/
api
/
v1
/
candidates
/
{id}
/
notes
Create candidate note
curl --request POST \
  --url https://app.outhire.ai/api/v1/candidates/{id}/notes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "note": "Referred by internal team."
}
'
{
  "data": {
    "id": 162,
    "candidate_id": 419,
    "type": "note_added",
    "note": "Referred by internal team.",
    "note_preview": "Referred by internal team.",
    "performer_id": null,
    "added_by": "api",
    "created_at": "2026-03-11T10:21:54.553198Z"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
integer
required

Numeric candidate id.

Body

application/json

Request body for appending a candidate note.

​
note
string
required

Full note body after trimming.

Required string length: 1 - 2000
Example:

"Referred by internal team."

Response

Candidate note created

Wrapper for a single candidate note resource.

​
data
object
required

Candidate note backed by a candidate_activities row.

Example:
{
  "id": 162,
  "candidate_id": 419,
  "type": "note_added",
  "note": "Referred by internal team.",
  "note_preview": "Referred by internal team.",
  "performer_id": null,
  "added_by": "api",
  "created_at": "2026-03-11T10:21:54.553198Z"
}