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
Candidate.bannerUrl · String scalar
The banner image from their profile.
Candidate.callLinks · CallLinkConnection! non-null object
The calls they were on, most recently linked first. A link that has been removed is not listed.
Candidate.callLinks.after · String scalar
Return the rows that follow this cursor.
Candidate.callLinks.before · String scalar
Return the rows that come before this cursor.
Candidate.callLinks.first · Int scalar
How many rows to return, from the start or from after. 50 when left out, 200 at most.
Candidate.callLinks.last · Int scalar
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.