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

RecordTouchInput

A message, call or meeting to record. Name who it was with by at least one of personId, candidateId and clientContactId: when more than one is given they must be the same person.

input RecordTouchInput {
  authorId: ID
  authorName: String
  body: String
  callId: ID
  candidateId: ID
  channel: TouchChannel!
  clientContactId: ID
  companyId: ID
  direction: TouchDirection!
  externalId: String
  externalSource: String
  externalThreadId: String
  jobId: ID
  occurredAt: DateTime
  opportunityId: ID
  personId: ID
  transcriptUrl: String
}

Fields

RecordTouchInput.authorId · ID scalar

The member who sent or took it. Must be a member of this workspace.

RecordTouchInput.authorName · String scalar

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

RecordTouchInput.body · String scalar

The message, or the summary of a call or meeting. 10,000 characters at most.

RecordTouchInput.callId · ID scalar

Kith ATS's recording of the call.

RecordTouchInput.candidateId · ID scalar

The candidate they were touched as. Their person is filled in. A candidate still in Kith ATS's sourcing review cannot be named.

RecordTouchInput.channel · TouchChannel! non-null enum

How it happened.

RecordTouchInput.clientContactId · ID scalar

The client contact they were touched as. Their person is filled in, and their company when companyId is left out.

RecordTouchInput.companyId · ID scalar

The company to file it under. Left out, it is the contact's company, else the client of the job, else the opportunity's company.

RecordTouchInput.direction · TouchDirection! non-null enum

Whether the workspace sent it or received it.

RecordTouchInput.externalId · String scalar

That system's id for the message. With externalSource, it makes the call safe to repeat.

RecordTouchInput.externalSource · String scalar

The system a synced touch came from, such as heyreach. Required when externalId is given.

RecordTouchInput.externalThreadId · String scalar

The conversation id from externalSource. Up to 300 characters. Several messages may share it.

RecordTouchInput.jobId · ID scalar

The job it was about.

RecordTouchInput.occurredAt · DateTime scalar

When it happened. Now, when left out.

RecordTouchInput.opportunityId · ID scalar

The opportunity it belongs to.

RecordTouchInput.personId · ID scalar

The person it was with.

RecordTouchInput.transcriptUrl · String scalar

A link to the transcript when it is kept elsewhere, as an http or https address.

Member Of

recordTouch mutation