Person
One human, whatever they are to the workspace: a candidate, a contact at a client, both, or neither yet. Candidates and client contacts stay the records of each role and point at their person, so someone who is a buyer and a candidate has one history.
type Person {
buyerType: BuyerType
candidates(
after: String
before: String
first: Int
last: Int
): CandidateConnection!
clientContacts(
after: String
before: String
first: Int
last: Int
): ClientContactConnection!
company: Company
createdAt: DateTime!
emails: [PersonEmail!]!
fieldValues(
after: String
before: String
first: Int
last: Int
): FieldValueConnection!
id: ID!
isCandidate: Boolean!
isClientContact: Boolean!
linkedinUrl: String
location: String
manages: String
name: String!
owner: User
phones: [String!]!
presentations(
after: String
before: String
first: Int
last: Int
): PresentationConnection!
presentationsReceived(
after: String
before: String
first: Int
last: Int
): PresentationConnection!
referredBy: Person
reportsTo: Person
reportsToName: String
restrictions(
after: String
before: String
first: Int
last: Int
): RestrictionConnection!
source: PersonSource
title: String
touchThread(
after: String
before: String
filter: TouchThreadFilter!
first: Int
last: Int
): TouchConnection!
touches(
after: String
before: String
first: Int
last: Int
): TouchConnection!
updatedAt: DateTime!
}Fields
Person.buyerType · BuyerType enum
What kind of buyer they are, for someone who hires.
Person.candidates · CandidateConnection! non-null object
The candidate records that are this person, in the order they were added. Usually one. A candidate still in Kith ATS's sourcing review is not included.
Person.candidates.after · String scalar
Return the rows that follow this cursor.
Person.candidates.before · String scalar
Return the rows that come before this cursor.
Person.candidates.first · Int scalar
How many rows to return, from the start or from after. 50 when left out, 200 at most.
Person.candidates.last · Int scalar
How many rows to return, counting back from the end or from before. 200 at most.
Person.clientContacts · ClientContactConnection! non-null object
The client contacts that are this person, in the order they were added. Usually one.
Person.clientContacts.after · String scalar
Return the rows that follow this cursor.
Person.clientContacts.before · String scalar
Return the rows that come before this cursor.
Person.clientContacts.first · Int scalar
How many rows to return, from the start or from after. 50 when left out, 200 at most.
Person.clientContacts.last · Int scalar
How many rows to return, counting back from the end or from before. 200 at most.
Person.company · Company object
The company they work at today.
Person.createdAt · DateTime! non-null scalar
When the person was first recorded.
Person.emails · [PersonEmail!]! non-null object
Their email addresses. Empty when none is known.
Person.fieldValues · FieldValueConnection! non-null object
The workspace's own fields that have a value on them, in the order they were first set.
Person.fieldValues.after · String scalar
Return the rows that follow this cursor.
Person.fieldValues.before · String scalar
Return the rows that come before this cursor.
Person.fieldValues.first · Int scalar
How many rows to return, from the start or from after. 50 when left out, 200 at most.
Person.fieldValues.last · Int scalar
How many rows to return, counting back from the end or from before. 200 at most.
Person.id · ID! non-null scalar
The person's id.
Person.isCandidate · Boolean! non-null scalar
True when a candidate record the workspace can see is this person. Worked out by the server; not writable.
Person.isClientContact · Boolean! non-null scalar
True when a client contact is this person. Worked out by the server; not writable.
Person.linkedinUrl · String scalar
Their LinkedIn profile.
Person.location · String scalar
Where they are based, as written.
Person.manages · String scalar
Who or what they manage, in words, such as Two SDRs.
Person.name · String! non-null scalar
Their full name.
Person.owner · User object
The member who looks after the relationship with them. Null when nobody does, or they have left the workspace.
Person.phones · [String!]! non-null scalar
Their phone numbers, as they were entered.
Person.presentations · PresentationConnection! non-null object
The times they were shown to a buyer as a candidate, newest recorded first.
Person.presentations.after · String scalar
Return the rows that follow this cursor.
Person.presentations.before · String scalar
Return the rows that come before this cursor.
Person.presentations.first · Int scalar
How many rows to return, from the start or from after. 50 when left out, 200 at most.
Person.presentations.last · Int scalar
How many rows to return, counting back from the end or from before. 200 at most.
Person.presentationsReceived · PresentationConnection! non-null object
The candidates shown to them as a buyer, newest recorded first.
Person.presentationsReceived.after · String scalar
Return the rows that follow this cursor.
Person.presentationsReceived.before · String scalar
Return the rows that come before this cursor.
Person.presentationsReceived.first · Int scalar
How many rows to return, from the start or from after. 50 when left out, 200 at most.
Person.presentationsReceived.last · Int scalar
How many rows to return, counting back from the end or from before. 200 at most.
Person.referredBy · Person object
The person who referred them.
Person.reportsTo · Person object
The person they report to, when that person is in the workspace.
Person.reportsToName · String scalar
Who they report to, by name, when that person is not in the workspace.
Person.restrictions · RestrictionConnection! non-null object
The do-not-contact rules on them, oldest first. Read isInForce on each before messaging them.
Person.restrictions.after · String scalar
Return the rows that follow this cursor.
Person.restrictions.before · String scalar
Return the rows that come before this cursor.
Person.restrictions.first · Int scalar
How many rows to return, from the start or from after. 50 when left out, 200 at most.
Person.restrictions.last · Int scalar
How many rows to return, counting back from the end or from before. 200 at most.
Person.source · PersonSource enum
How they came to be known.
Person.title · String scalar
Their job title today.
Person.touchThread · TouchConnection! non-null object
Messages with this person in one external conversation, earliest occurrence first, then by id.
Person.touchThread.after · String scalar
Return the rows that follow this cursor.
Person.touchThread.before · String scalar
Return the rows that come before this cursor.
Person.touchThread.filter · TouchThreadFilter! non-null input
The source and id of the external thread.
Person.touchThread.first · Int scalar
How many rows to return, from the start or from after. 50 when left out, 200 at most.
Person.touchThread.last · Int scalar
How many rows to return, counting back from the end or from before. 200 at most.
Person.touches · TouchConnection! non-null object
Every message, call and meeting with them, whichever record it was written against, newest recorded first.
Person.touches.after · String scalar
Return the rows that follow this cursor.
Person.touches.before · String scalar
Return the rows that come before this cursor.
Person.touches.first · Int scalar
How many rows to return, from the start or from after. 50 when left out, 200 at most.
Person.touches.last · Int scalar
How many rows to return, counting back from the end or from before. 200 at most.
Person.updatedAt · DateTime! non-null scalar
When their record last changed.
Returned By
person query
Member Of
AcceptChangeSuggestionPayload object · Candidate object · ChangeSuggestion object · ClientContact object · CreatePersonPayload object · FieldValue object · Opportunity object · OpportunityContact object · Person object · PersonEdge object · Presentation object · Restriction object · SetCandidatePersonPayload object · Touch object · UpdatePersonPayload object