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

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

On this page

FieldsPerson.buyerType · BuyerType enumPerson.candidates · CandidateConnection! non-null objectPerson.candidates.after · String scalarPerson.candidates.before · String scalarPerson.candidates.first · Int scalarPerson.candidates.last · Int scalarPerson.clientContacts · ClientContactConnection! non-null objectPerson.clientContacts.after · String scalarPerson.clientContacts.before · String scalarPerson.clientContacts.first · Int scalarPerson.clientContacts.last · Int scalarPerson.company · Company objectPerson.createdAt · DateTime! non-null scalarPerson.emails · [PersonEmail!]! non-null objectPerson.fieldValues · FieldValueConnection! non-null objectPerson.fieldValues.after · String scalarPerson.fieldValues.before · String scalarPerson.fieldValues.first · Int scalarPerson.fieldValues.last · Int scalarPerson.id · ID! non-null scalarPerson.isCandidate · Boolean! non-null scalarPerson.isClientContact · Boolean! non-null scalarPerson.linkedinUrl · String scalarPerson.location · String scalarPerson.manages · String scalarPerson.name · String! non-null scalarPerson.owner · User objectPerson.phones · [String!]! non-null scalarPerson.presentations · PresentationConnection! non-null objectPerson.presentations.after · String scalarPerson.presentations.before · String scalarPerson.presentations.first · Int scalarPerson.presentations.last · Int scalarPerson.presentationsReceived · PresentationConnection! non-null objectPerson.presentationsReceived.after · String scalarPerson.presentationsReceived.before · String scalarPerson.presentationsReceived.first · Int scalarPerson.presentationsReceived.last · Int scalarPerson.referredBy · Person objectPerson.reportsTo · Person objectPerson.reportsToName · String scalarPerson.restrictions · RestrictionConnection! non-null objectPerson.restrictions.after · String scalarPerson.restrictions.before · String scalarPerson.restrictions.first · Int scalarPerson.restrictions.last · Int scalarPerson.source · PersonSource enumPerson.title · String scalarPerson.touchThread · TouchConnection! non-null objectPerson.touchThread.after · String scalarPerson.touchThread.before · String scalarPerson.touchThread.filter · TouchThreadFilter! non-null inputPerson.touchThread.first · Int scalarPerson.touchThread.last · Int scalarPerson.touches · TouchConnection! non-null objectPerson.touches.after · String scalarPerson.touches.before · String scalarPerson.touches.first · Int scalarPerson.touches.last · Int scalarPerson.updatedAt · DateTime! non-null scalarReturned ByMember Of