# Person (/api/reference/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.

```graphql
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 [#fields]

#### [`Person.buyerType`](#buyer-type) · [`BuyerType`](/api/reference/enums/buyer-type) `enum` [#buyer-type]
What kind of buyer they are, for someone who hires.

#### [`Person.candidates`](#candidates) · [`CandidateConnection!`](/api/reference/objects/candidate-connection) `non-null` `object` [#candidates]
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`](#person-candidates-after) · [`String`](/api/reference/scalars/string) `scalar` [#person-candidates-after]
Return the rows that follow this cursor.

##### [`Person.candidates.before`](#person-candidates-before) · [`String`](/api/reference/scalars/string) `scalar` [#person-candidates-before]
Return the rows that come before this cursor.

##### [`Person.candidates.first`](#person-candidates-first) · [`Int`](/api/reference/scalars/int) `scalar` [#person-candidates-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Person.candidates.last`](#person-candidates-last) · [`Int`](/api/reference/scalars/int) `scalar` [#person-candidates-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Person.clientContacts`](#client-contacts) · [`ClientContactConnection!`](/api/reference/objects/client-contact-connection) `non-null` `object` [#client-contacts]
The client contacts that are this person, in the order they were added. Usually one.
##### [`Person.clientContacts.after`](#person-client-contacts-after) · [`String`](/api/reference/scalars/string) `scalar` [#person-client-contacts-after]
Return the rows that follow this cursor.

##### [`Person.clientContacts.before`](#person-client-contacts-before) · [`String`](/api/reference/scalars/string) `scalar` [#person-client-contacts-before]
Return the rows that come before this cursor.

##### [`Person.clientContacts.first`](#person-client-contacts-first) · [`Int`](/api/reference/scalars/int) `scalar` [#person-client-contacts-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Person.clientContacts.last`](#person-client-contacts-last) · [`Int`](/api/reference/scalars/int) `scalar` [#person-client-contacts-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Person.company`](#company) · [`Company`](/api/reference/objects/company) `object` [#company]
The company they work at today.

#### [`Person.createdAt`](#created-at) · [`DateTime!`](/api/reference/scalars/date-time) `non-null` `scalar` [#created-at]
When the person was first recorded.

#### [`Person.emails`](#emails) · [`[PersonEmail!]!`](/api/reference/objects/person-email) `non-null` `object` [#emails]
Their email addresses. Empty when none is known.

#### [`Person.fieldValues`](#field-values) · [`FieldValueConnection!`](/api/reference/objects/field-value-connection) `non-null` `object` [#field-values]
The workspace's own fields that have a value on them, in the order they were first set.
##### [`Person.fieldValues.after`](#person-field-values-after) · [`String`](/api/reference/scalars/string) `scalar` [#person-field-values-after]
Return the rows that follow this cursor.

##### [`Person.fieldValues.before`](#person-field-values-before) · [`String`](/api/reference/scalars/string) `scalar` [#person-field-values-before]
Return the rows that come before this cursor.

##### [`Person.fieldValues.first`](#person-field-values-first) · [`Int`](/api/reference/scalars/int) `scalar` [#person-field-values-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Person.fieldValues.last`](#person-field-values-last) · [`Int`](/api/reference/scalars/int) `scalar` [#person-field-values-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

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

#### [`Person.isCandidate`](#is-candidate) · [`Boolean!`](/api/reference/scalars/boolean) `non-null` `scalar` [#is-candidate]
True when a candidate record the workspace can see is this person. Worked out by the server; not writable.

#### [`Person.isClientContact`](#is-client-contact) · [`Boolean!`](/api/reference/scalars/boolean) `non-null` `scalar` [#is-client-contact]
True when a client contact is this person. Worked out by the server; not writable.

#### [`Person.linkedinUrl`](#linkedin-url) · [`String`](/api/reference/scalars/string) `scalar` [#linkedin-url]
Their LinkedIn profile.

#### [`Person.location`](#location) · [`String`](/api/reference/scalars/string) `scalar` [#location]
Where they are based, as written.

#### [`Person.manages`](#manages) · [`String`](/api/reference/scalars/string) `scalar` [#manages]
Who or what they manage, in words, such as `Two SDRs`.

#### [`Person.name`](#name) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#name]
Their full name.

#### [`Person.owner`](#owner) · [`User`](/api/reference/objects/user) `object` [#owner]
The member who looks after the relationship with them. Null when nobody does, or they have left the workspace.

#### [`Person.phones`](#phones) · [`[String!]!`](/api/reference/scalars/string) `non-null` `scalar` [#phones]
Their phone numbers, as they were entered.

#### [`Person.presentations`](#presentations) · [`PresentationConnection!`](/api/reference/objects/presentation-connection) `non-null` `object` [#presentations]
The times they were shown to a buyer as a candidate, newest recorded first.
##### [`Person.presentations.after`](#person-presentations-after) · [`String`](/api/reference/scalars/string) `scalar` [#person-presentations-after]
Return the rows that follow this cursor.

##### [`Person.presentations.before`](#person-presentations-before) · [`String`](/api/reference/scalars/string) `scalar` [#person-presentations-before]
Return the rows that come before this cursor.

##### [`Person.presentations.first`](#person-presentations-first) · [`Int`](/api/reference/scalars/int) `scalar` [#person-presentations-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Person.presentations.last`](#person-presentations-last) · [`Int`](/api/reference/scalars/int) `scalar` [#person-presentations-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Person.presentationsReceived`](#presentations-received) · [`PresentationConnection!`](/api/reference/objects/presentation-connection) `non-null` `object` [#presentations-received]
The candidates shown to them as a buyer, newest recorded first.
##### [`Person.presentationsReceived.after`](#person-presentations-received-after) · [`String`](/api/reference/scalars/string) `scalar` [#person-presentations-received-after]
Return the rows that follow this cursor.

##### [`Person.presentationsReceived.before`](#person-presentations-received-before) · [`String`](/api/reference/scalars/string) `scalar` [#person-presentations-received-before]
Return the rows that come before this cursor.

##### [`Person.presentationsReceived.first`](#person-presentations-received-first) · [`Int`](/api/reference/scalars/int) `scalar` [#person-presentations-received-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Person.presentationsReceived.last`](#person-presentations-received-last) · [`Int`](/api/reference/scalars/int) `scalar` [#person-presentations-received-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Person.referredBy`](#referred-by) · [`Person`](/api/reference/objects/person) `object` [#referred-by]
The person who referred them.

#### [`Person.reportsTo`](#reports-to) · [`Person`](/api/reference/objects/person) `object` [#reports-to]
The person they report to, when that person is in the workspace.

#### [`Person.reportsToName`](#reports-to-name) · [`String`](/api/reference/scalars/string) `scalar` [#reports-to-name]
Who they report to, by name, when that person is not in the workspace.

#### [`Person.restrictions`](#restrictions) · [`RestrictionConnection!`](/api/reference/objects/restriction-connection) `non-null` `object` [#restrictions]
The do-not-contact rules on them, oldest first. Read `isInForce` on each before messaging them.
##### [`Person.restrictions.after`](#person-restrictions-after) · [`String`](/api/reference/scalars/string) `scalar` [#person-restrictions-after]
Return the rows that follow this cursor.

##### [`Person.restrictions.before`](#person-restrictions-before) · [`String`](/api/reference/scalars/string) `scalar` [#person-restrictions-before]
Return the rows that come before this cursor.

##### [`Person.restrictions.first`](#person-restrictions-first) · [`Int`](/api/reference/scalars/int) `scalar` [#person-restrictions-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Person.restrictions.last`](#person-restrictions-last) · [`Int`](/api/reference/scalars/int) `scalar` [#person-restrictions-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Person.source`](#source) · [`PersonSource`](/api/reference/enums/person-source) `enum` [#source]
How they came to be known.

#### [`Person.title`](#title) · [`String`](/api/reference/scalars/string) `scalar` [#title]
Their job title today.

#### [`Person.touchThread`](#touch-thread) · [`TouchConnection!`](/api/reference/objects/touch-connection) `non-null` `object` [#touch-thread]
Messages with this person in one external conversation, earliest occurrence first, then by id.
##### [`Person.touchThread.after`](#person-touch-thread-after) · [`String`](/api/reference/scalars/string) `scalar` [#person-touch-thread-after]
Return the rows that follow this cursor.

##### [`Person.touchThread.before`](#person-touch-thread-before) · [`String`](/api/reference/scalars/string) `scalar` [#person-touch-thread-before]
Return the rows that come before this cursor.

##### [`Person.touchThread.filter`](#person-touch-thread-filter) · [`TouchThreadFilter!`](/api/reference/inputs/touch-thread-filter) `non-null` `input` [#person-touch-thread-filter]
The source and id of the external thread.

##### [`Person.touchThread.first`](#person-touch-thread-first) · [`Int`](/api/reference/scalars/int) `scalar` [#person-touch-thread-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Person.touchThread.last`](#person-touch-thread-last) · [`Int`](/api/reference/scalars/int) `scalar` [#person-touch-thread-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Person.touches`](#touches) · [`TouchConnection!`](/api/reference/objects/touch-connection) `non-null` `object` [#touches]
Every message, call and meeting with them, whichever record it was written against, newest recorded first.
##### [`Person.touches.after`](#person-touches-after) · [`String`](/api/reference/scalars/string) `scalar` [#person-touches-after]
Return the rows that follow this cursor.

##### [`Person.touches.before`](#person-touches-before) · [`String`](/api/reference/scalars/string) `scalar` [#person-touches-before]
Return the rows that come before this cursor.

##### [`Person.touches.first`](#person-touches-first) · [`Int`](/api/reference/scalars/int) `scalar` [#person-touches-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Person.touches.last`](#person-touches-last) · [`Int`](/api/reference/scalars/int) `scalar` [#person-touches-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Person.updatedAt`](#updated-at) · [`DateTime!`](/api/reference/scalars/date-time) `non-null` `scalar` [#updated-at]
When their record last changed.

### Returned By [#returned-by]

[`person`](/api/reference/queries/person)  `query`

### Member Of [#member-of]

[`AcceptChangeSuggestionPayload`](/api/reference/objects/accept-change-suggestion-payload)  `object` · [`Candidate`](/api/reference/objects/candidate)  `object` · [`ChangeSuggestion`](/api/reference/objects/change-suggestion)  `object` · [`ClientContact`](/api/reference/objects/client-contact)  `object` · [`CreatePersonPayload`](/api/reference/objects/create-person-payload)  `object` · [`FieldValue`](/api/reference/objects/field-value)  `object` · [`Opportunity`](/api/reference/objects/opportunity)  `object` · [`OpportunityContact`](/api/reference/objects/opportunity-contact)  `object` · [`Person`](/api/reference/objects/person)  `object` · [`PersonEdge`](/api/reference/objects/person-edge)  `object` · [`Presentation`](/api/reference/objects/presentation)  `object` · [`Restriction`](/api/reference/objects/restriction)  `object` · [`SetCandidatePersonPayload`](/api/reference/objects/set-candidate-person-payload)  `object` · [`Touch`](/api/reference/objects/touch)  `object` · [`UpdatePersonPayload`](/api/reference/objects/update-person-payload)  `object`