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

Touch

One message, call or meeting with a person, in either direction: what was actually said. (A recruiter's own note about a candidate is a different record.) A touch belongs to a person.

type Touch {
  author: User
  authorName: String
  body: String
  candidate: Candidate
  channel: TouchChannel!
  clientContact: ClientContact
  company: Company
  createdAt: DateTime!
  direction: TouchDirection!
  externalId: String
  externalSource: String
  externalThreadId: String
  id: ID!
  job: Job
  occurredAt: DateTime!
  opportunity: Opportunity
  person: Person!
  transcriptUrl: String
  updatedAt: DateTime!
}

Fields

Touch.author · User object

The member who sent or took it. Null when it was someone who is not a member, or they have left.

Touch.authorName · String scalar

Who sent or took it, by name, when they are not a member.

Touch.body · String scalar

The message as sent or received, or the summary of a call or meeting.

Touch.candidate · Candidate object

The candidate record they were touched as, when the writer named one. Null too for a candidate still in Kith ATS's sourcing review.

Touch.channel · TouchChannel! non-null enum

How it happened.

Touch.clientContact · ClientContact object

The client contact they were touched as, when the writer named one.

Touch.company · Company object

The company it is filed under: the one the writer named, else the contact's, else the client of the job it was about, else the opportunity's.

Touch.createdAt · DateTime! non-null scalar

When the touch was recorded.

Touch.direction · TouchDirection! non-null enum

Whether the workspace sent it or received it.

Touch.externalId · String scalar

That system's id for the message. The same id from the same system is stored once per person.

Touch.externalSource · String scalar

The system a synced touch came from, such as heyreach or gmail.

Touch.externalThreadId · String scalar

The source system’s conversation id, when this touch belongs to a thread.

Touch.id · ID! non-null scalar

The touch's id.

Touch.job · Job object

The job it was about.

Touch.occurredAt · DateTime! non-null scalar

When it happened, which may be long before it was recorded.

Touch.opportunity · Opportunity object

The opportunity it belongs to.

Touch.person · Person! non-null object

Who it was with.

Touch.transcriptUrl · String scalar

A link to the transcript when it is kept somewhere else.

Touch.updatedAt · DateTime! non-null scalar

When the record last changed.

Returned By

touch query

Member Of

ChangeSuggestionEvidence object · FieldValue object · Presentation object · RecordTouchPayload object · TouchEdge object · UpdateTouchPayload object