# CandidateNote (/api/reference/objects/candidate-note)

A note left on a candidate's timeline: something a recruiter typed or dictated, a client's feedback, a note an agent or another system wrote. A note may be about one job or about the person in general. This is not `Candidate.notes` or `JobCandidate.notes`, which are single fields of free text.

```graphql
type CandidateNote {
  agentName: String
  author: User
  candidate: Candidate!
  externalAuthorName: String
  externalId: String
  externalSource: String
  id: ID!
  job: Job
  source: String!
  text: String
  writtenAt: DateTime!
}
```

### Fields [#fields]

#### [`CandidateNote.agentName`](#agent-name) · [`String`](/api/reference/scalars/string) `scalar` [#agent-name]
The name of the Kith ATS agent that wrote it, when one did.

#### [`CandidateNote.author`](#author) · [`User`](/api/reference/objects/user) `object` [#author]
The member who wrote it. Null for a note from an agent or another system, for older notes that recorded no author, and for a member who has left.

#### [`CandidateNote.candidate`](#candidate) · [`Candidate!`](/api/reference/objects/candidate) `non-null` `object` [#candidate]
The candidate it is about.

#### [`CandidateNote.externalAuthorName`](#external-author-name) · [`String`](/api/reference/scalars/string) `scalar` [#external-author-name]
The author's name as another system gave it, for a note whose author is not a member, such as a note from Kith. For display only.

#### [`CandidateNote.externalId`](#external-id) · [`String`](/api/reference/scalars/string) `scalar` [#external-id]
That system's own id for the note. Null for a note written in Kith ATS.

#### [`CandidateNote.externalSource`](#external-source) · [`String`](/api/reference/scalars/string) `scalar` [#external-source]
The system the note was brought in from, such as `kith` or `contextos`. Null for a note written in Kith ATS.

#### [`CandidateNote.id`](#id) · [`ID!`](/api/reference/scalars/id) `non-null` `scalar` [#id]
The note's id.

#### [`CandidateNote.job`](#job) · [`Job`](/api/reference/objects/job) `object` [#job]
The job it was left about. Null for a general note about the person.

#### [`CandidateNote.source`](#source) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#source]
How the note came about, in lower case: `typed_note` and `voice_note` from the app, `client_feedback` from a client, `client_share_note` for the note written for a client share, `kith` for a note from Kith, `linkedin_sync` and the like from imports. An integration may use its own word.

#### [`CandidateNote.text`](#text) · [`String`](/api/reference/scalars/string) `scalar` [#text]
The note's words. Null for an entry that records an event without text.

#### [`CandidateNote.writtenAt`](#written-at) · [`DateTime!`](/api/reference/scalars/date-time) `non-null` `scalar` [#written-at]
When it was written, or when what it records happened.

### Member Of [#member-of]

[`AddCandidateNotePayload`](/api/reference/objects/add-candidate-note-payload)  `object` · [`CandidateNoteEdge`](/api/reference/objects/candidate-note-edge)  `object` · [`JobCandidate`](/api/reference/objects/job-candidate)  `object`