New: Kith open-sources its ATS.Read why
Skip to Content
Objects

Candidate

A person a workspace knows as a possible hire. They are in the workspace's records whether or not they are on a job: see jobs for the jobs they are on.

type Candidate {
  bannerUrl: String
  callLinks(
    after: String
    before: String
    first: Int
    last: Int
  ): CallLinkConnection!
  createdAt: DateTime!
  currentCompany: String
  currentEmployer: Company
  currentTitle: String
  cvUrl: String
  documents(
    after: String
    before: String
    first: Int
    last: Int
  ): CandidateDocumentConnection!
  email: String
  emailVerifiedAt: DateTime
  emailVerifiedBy: EmailVerifier
  employments(
    after: String
    before: String
    filter: CandidateOwnEmploymentFilter
    first: Int
    last: Int
  ): CandidateEmploymentConnection!
  facts(
    after: String
    before: String
    filter: CandidateOwnFactFilter
    first: Int
    last: Int
  ): CandidateFactConnection!
  favouritedAt: DateTime
  id: ID!
  isArchived: Boolean!
  isEmailVerified: Boolean!
  jobs(
    after: String
    before: String
    first: Int
    last: Int
  ): JobCandidateConnection!
  knownBy(
    after: String
    before: String
    first: Int
    last: Int
  ): CandidateRelationshipConnection!
  lastActivityAt: DateTime
  lastActivityBy: User
  lastActivityKind: CandidateActivityKind
  lastCallAt: DateTime
  lastCallTitle: String
  lastNoteAt: DateTime
  latestCall: Call
  linkedinUrl: String
  location: String
  locationCity: String
  locationCountryCode: String
  locationRegion: String
  name: String!
  notes: String
  owner: User
  person: Person
  phone: String
  photoUrl: String
  presentations(
    after: String
    before: String
    first: Int
    last: Int
  ): PresentationConnection!
  relationshipSignals(
    after: String
    before: String
    filter: CandidateRelationshipSignalFilter
    first: Int
    last: Int
  ): RelationshipSignalConnection!
  roleRecommendations: [RoleRecommendation!]!
  salary: String
  source: String
  tags: [String!]!
  timelineNotes(
    after: String
    before: String
    first: Int
    last: Int
  ): CandidateNoteConnection!
  touches(
    after: String
    before: String
    first: Int
    last: Int
  ): TouchConnection!
  updatedAt: DateTime!
  yearsExperience: Int
}

Fields

The banner image from their profile.

The calls they were on, most recently linked first. A link that has been removed is not listed.

Return the rows that follow this cursor.

Return the rows that come before this cursor.

How many rows to return, from the start or from after. 50 when left out, 200 at most.

How many rows to return, counting back from the end or from before. 200 at most.

Candidate.createdAt · DateTime! non-null scalar

When they were added to the workspace.

Candidate.currentCompany · String scalar

The name of the company they work at today.

Candidate.currentEmployer · Company object

The company record their current employer has been matched to. Null until currentCompany has been matched to one.

Candidate.currentTitle · String scalar

Their job title today.

Candidate.cvUrl · String scalar

A link to their CV.

Candidate.documents · CandidateDocumentConnection! non-null object

Their uploaded documents, newest first.

Candidate.documents.after · String scalar

Return the rows that follow this cursor.

Candidate.documents.before · String scalar

Return the rows that come before this cursor.

Candidate.documents.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Candidate.documents.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Candidate.email · String scalar

Their email address.

Candidate.emailVerifiedAt · DateTime scalar

When the email address was confirmed to reach them. Null when isEmailVerified is false.

Candidate.emailVerifiedBy · EmailVerifier enum

How the email address was confirmed. Null when it has not been.

Candidate.employments · CandidateEmploymentConnection! non-null object

The roles they have held: current ones first, then the most recently started.

Candidate.employments.after · String scalar

Return the rows that follow this cursor.

Candidate.employments.before · String scalar

Return the rows that come before this cursor.

Candidate.employments.filter · CandidateOwnEmploymentFilter input

Narrow the list. Left out, current and past roles are returned.

Candidate.employments.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Candidate.employments.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Candidate.facts · CandidateFactConnection! non-null object

Facts recorded about them, such as deal sizes or languages, in order of kind.

Candidate.facts.after · String scalar

Return the rows that follow this cursor.

Candidate.facts.before · String scalar

Return the rows that come before this cursor.

Candidate.facts.filter · CandidateOwnFactFilter input

Narrow the list. Left out, every fact is returned.

Candidate.facts.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Candidate.facts.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Candidate.favouritedAt · DateTime scalar

When the workspace marked them as exceptional. Null when it has not.

Candidate.id · ID! non-null scalar

The candidate's id, as in their URL in the app.

Candidate.isArchived · Boolean! non-null scalar

True when they have been put away and are left out of everyday lists.

Candidate.isEmailVerified · Boolean! non-null scalar

True when an enrichment provider confirmed the email address reaches them.

Candidate.jobs · JobCandidateConnection! non-null object

The jobs they are on, each with their stage, grade and decision there, in the order they were added.

Candidate.jobs.after · String scalar

Return the rows that follow this cursor.

Candidate.jobs.before · String scalar

Return the rows that come before this cursor.

Candidate.jobs.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Candidate.jobs.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Candidate.knownBy · CandidateRelationshipConnection! non-null object

The teammates who know them personally, in the order they were recorded.

Candidate.knownBy.after · String scalar

Return the rows that follow this cursor.

Candidate.knownBy.before · String scalar

Return the rows that come before this cursor.

Candidate.knownBy.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Candidate.knownBy.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Candidate.lastActivityAt · DateTime scalar

When anything last happened with them: a note, a call, a stage move or a decision. Worked out from what the workspace may read: a note or stage move on a job they are not yet released on does not count.

Candidate.lastActivityBy · User object

The teammate who did the latest thing counted in lastActivityAt, when a person did it and it is known who. Null for a teammate who has left the workspace.

Candidate.lastActivityKind · CandidateActivityKind enum

What that latest thing was.

Candidate.lastCallAt · DateTime scalar

When the latest recorded call with them took place.

Candidate.lastCallTitle · String scalar

The title of that latest call.

Candidate.lastNoteAt · DateTime scalar

When someone last left a note about them. A note about a job they are not yet released on does not count.

Candidate.latestCall · Call object

The latest call they were on, by when it was held. Null when no call is linked to them.

Candidate.linkedinUrl · String scalar

Their LinkedIn profile.

Candidate.location · String scalar

Where they are based, as written on their profile.

Candidate.locationCity · String scalar

The city from location, when it could be worked out.

Candidate.locationCountryCode · String scalar

The country from location, as a two-letter ISO 3166 code such as GB.

Candidate.locationRegion · String scalar

The state, county or region from location, when it could be worked out.

Candidate.name · String! non-null scalar

Their full name.

Candidate.notes · String scalar

General notes about them, apart from any job.

Candidate.owner · User object

The teammate responsible for them. Null when nobody is assigned, and for a teammate who has left the workspace.

Candidate.person · Person object

The person this candidate is. Shared with a client contact when the same human is both.

Candidate.phone · String scalar

Their phone number, as it was entered.

Candidate.photoUrl · String scalar

A photo of them.

Candidate.presentations · PresentationConnection! non-null object

The times they were shown to a buyer, newest recorded first.

Candidate.presentations.after · String scalar

Return the rows that follow this cursor.

Candidate.presentations.before · String scalar

Return the rows that come before this cursor.

Candidate.presentations.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Candidate.presentations.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Candidate.relationshipSignals · RelationshipSignalConnection! non-null object

The relationship signals about them that need attention now: open ones, and snoozed ones whose snooze has passed. Signals about the company they work at today are included. Most urgent first, then newest. Reading this records that the signals were shown to the reader, once for each signal.

Candidate.relationshipSignals.after · String scalar

Return the rows that follow this cursor.

Candidate.relationshipSignals.before · String scalar

Return the rows that come before this cursor.

Candidate.relationshipSignals.filter · CandidateRelationshipSignalFilter input

Narrow the list. Left out, every kind is returned.

Candidate.relationshipSignals.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Candidate.relationshipSignals.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Candidate.roleRecommendations · [RoleRecommendation!]! non-null object

The roles their calls point to: open recommendations, and ones already acted on by adding them to the job. One for each job, newest first. Empty when their calls named none, and for calls the reader may not see: the reader's own, or every call of the workspace when it shares them.

Candidate.salary · String scalar

What they earn or expect, as it was written down.

Candidate.source · String scalar

How they came to be in the workspace, such as an import or the browser extension.

Candidate.tags · [String!]! non-null scalar

The workspace's own labels for them.

Candidate.timelineNotes · CandidateNoteConnection! non-null object

The notes on their timeline: the note written for a client share first, then the newest by when it was written. A note about a job they are not yet released on is left out.

Candidate.timelineNotes.after · String scalar

Return the rows that follow this cursor.

Candidate.timelineNotes.before · String scalar

Return the rows that come before this cursor.

Candidate.timelineNotes.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Candidate.timelineNotes.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Candidate.touches · TouchConnection! non-null object

Every message, call and meeting recorded with them as a candidate, newest recorded first.

Candidate.touches.after · String scalar

Return the rows that follow this cursor.

Candidate.touches.before · String scalar

Return the rows that come before this cursor.

Candidate.touches.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Candidate.touches.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Candidate.updatedAt · DateTime! non-null scalar

When their record last changed.

Candidate.yearsExperience · Int scalar

How many years they have worked.

Returned By

candidate query

Member Of

AddedCandidate object · AttachCandidateDocumentPayload object · AttachUnmatchedCallPayload object · AttachUnmatchedCallToNewCandidatePayload object · AuditEntry object · CallAction object · CallLink object · CallRoleCheck object · CandidateDocument object · CandidateEdge object · CandidateEmployment object · CandidateFact object · CandidateNote object · CandidateRelationship object · JobCandidate object · Presentation object · RelationshipSignal object · SetCandidatePersonPayload object · Touch object · UnlinkCallFromCandidatePayload object · UnmatchedCall object

Shown in the UI

These components show it:

  • Review card: One person against a role, with your actions.
  • Inline card: A compact candidate row for lists and messages.
  • Profile: Identity, career history and contact channels.
  • Profile dialog: A profile in a dialog, or a drawer on a phone.
  • Cover header: A cover and an identity, as cards and profiles share them.

On this page

FieldsCandidate.bannerUrl · String scalarCandidate.callLinks · CallLinkConnection! non-null objectCandidate.callLinks.after · String scalarCandidate.callLinks.before · String scalarCandidate.callLinks.first · Int scalarCandidate.callLinks.last · Int scalarCandidate.createdAt · DateTime! non-null scalarCandidate.currentCompany · String scalarCandidate.currentEmployer · Company objectCandidate.currentTitle · String scalarCandidate.cvUrl · String scalarCandidate.documents · CandidateDocumentConnection! non-null objectCandidate.documents.after · String scalarCandidate.documents.before · String scalarCandidate.documents.first · Int scalarCandidate.documents.last · Int scalarCandidate.email · String scalarCandidate.emailVerifiedAt · DateTime scalarCandidate.emailVerifiedBy · EmailVerifier enumCandidate.employments · CandidateEmploymentConnection! non-null objectCandidate.employments.after · String scalarCandidate.employments.before · String scalarCandidate.employments.filter · CandidateOwnEmploymentFilter inputCandidate.employments.first · Int scalarCandidate.employments.last · Int scalarCandidate.facts · CandidateFactConnection! non-null objectCandidate.facts.after · String scalarCandidate.facts.before · String scalarCandidate.facts.filter · CandidateOwnFactFilter inputCandidate.facts.first · Int scalarCandidate.facts.last · Int scalarCandidate.favouritedAt · DateTime scalarCandidate.id · ID! non-null scalarCandidate.isArchived · Boolean! non-null scalarCandidate.isEmailVerified · Boolean! non-null scalarCandidate.jobs · JobCandidateConnection! non-null objectCandidate.jobs.after · String scalarCandidate.jobs.before · String scalarCandidate.jobs.first · Int scalarCandidate.jobs.last · Int scalarCandidate.knownBy · CandidateRelationshipConnection! non-null objectCandidate.knownBy.after · String scalarCandidate.knownBy.before · String scalarCandidate.knownBy.first · Int scalarCandidate.knownBy.last · Int scalarCandidate.lastActivityAt · DateTime scalarCandidate.lastActivityBy · User objectCandidate.lastActivityKind · CandidateActivityKind enumCandidate.lastCallAt · DateTime scalarCandidate.lastCallTitle · String scalarCandidate.lastNoteAt · DateTime scalarCandidate.latestCall · Call objectCandidate.linkedinUrl · String scalarCandidate.location · String scalarCandidate.locationCity · String scalarCandidate.locationCountryCode · String scalarCandidate.locationRegion · String scalarCandidate.name · String! non-null scalarCandidate.notes · String scalarCandidate.owner · User objectCandidate.person · Person objectCandidate.phone · String scalarCandidate.photoUrl · String scalarCandidate.presentations · PresentationConnection! non-null objectCandidate.presentations.after · String scalarCandidate.presentations.before · String scalarCandidate.presentations.first · Int scalarCandidate.presentations.last · Int scalarCandidate.relationshipSignals · RelationshipSignalConnection! non-null objectCandidate.relationshipSignals.after · String scalarCandidate.relationshipSignals.before · String scalarCandidate.relationshipSignals.filter · CandidateRelationshipSignalFilter inputCandidate.relationshipSignals.first · Int scalarCandidate.relationshipSignals.last · Int scalarCandidate.roleRecommendations · [RoleRecommendation!]! non-null objectCandidate.salary · String scalarCandidate.source · String scalarCandidate.tags · [String!]! non-null scalarCandidate.timelineNotes · CandidateNoteConnection! non-null objectCandidate.timelineNotes.after · String scalarCandidate.timelineNotes.before · String scalarCandidate.timelineNotes.first · Int scalarCandidate.timelineNotes.last · Int scalarCandidate.touches · TouchConnection! non-null objectCandidate.touches.after · String scalarCandidate.touches.before · String scalarCandidate.touches.first · Int scalarCandidate.touches.last · Int scalarCandidate.updatedAt · DateTime! non-null scalarCandidate.yearsExperience · Int scalarReturned ByMember OfShown in the UI