# RecordTouchInput (/api/reference/inputs/record-touch-input)

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.

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

#### [`RecordTouchInput.authorId`](#author-id) · [`ID`](/api/reference/scalars/id) `scalar` [#author-id]
The member who sent or took it. Must be a member of this workspace.

#### [`RecordTouchInput.authorName`](#author-name) · [`String`](/api/reference/scalars/string) `scalar` [#author-name]
Who sent or took it, by name, when they are not a member.

#### [`RecordTouchInput.body`](#body) · [`String`](/api/reference/scalars/string) `scalar` [#body]
The message, or the summary of a call or meeting. 10,000 characters at most.

#### [`RecordTouchInput.callId`](#call-id) · [`ID`](/api/reference/scalars/id) `scalar` [#call-id]
Kith ATS's recording of the call.

#### [`RecordTouchInput.candidateId`](#candidate-id) · [`ID`](/api/reference/scalars/id) `scalar` [#candidate-id]
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`](#channel) · [`TouchChannel!`](/api/reference/enums/touch-channel) `non-null` `enum` [#channel]
How it happened.

#### [`RecordTouchInput.clientContactId`](#client-contact-id) · [`ID`](/api/reference/scalars/id) `scalar` [#client-contact-id]
The client contact they were touched as. Their person is filled in, and their company when `companyId` is left out.

#### [`RecordTouchInput.companyId`](#company-id) · [`ID`](/api/reference/scalars/id) `scalar` [#company-id]
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`](#direction) · [`TouchDirection!`](/api/reference/enums/touch-direction) `non-null` `enum` [#direction]
Whether the workspace sent it or received it.

#### [`RecordTouchInput.externalId`](#external-id) · [`String`](/api/reference/scalars/string) `scalar` [#external-id]
That system's id for the message. With `externalSource`, it makes the call safe to repeat.

#### [`RecordTouchInput.externalSource`](#external-source) · [`String`](/api/reference/scalars/string) `scalar` [#external-source]
The system a synced touch came from, such as `heyreach`. Required when `externalId` is given.

#### [`RecordTouchInput.externalThreadId`](#external-thread-id) · [`String`](/api/reference/scalars/string) `scalar` [#external-thread-id]
The conversation id from externalSource. Up to 300 characters. Several messages may share it.

#### [`RecordTouchInput.jobId`](#job-id) · [`ID`](/api/reference/scalars/id) `scalar` [#job-id]
The job it was about.

#### [`RecordTouchInput.occurredAt`](#occurred-at) · [`DateTime`](/api/reference/scalars/date-time) `scalar` [#occurred-at]
When it happened. Now, when left out.

#### [`RecordTouchInput.opportunityId`](#opportunity-id) · [`ID`](/api/reference/scalars/id) `scalar` [#opportunity-id]
The opportunity it belongs to.

#### [`RecordTouchInput.personId`](#person-id) · [`ID`](/api/reference/scalars/id) `scalar` [#person-id]
The person it was with.

#### [`RecordTouchInput.transcriptUrl`](#transcript-url) · [`String`](/api/reference/scalars/string) `scalar` [#transcript-url]
A link to the transcript when it is kept elsewhere, as an http or https address.

### Member Of [#member-of]

[`recordTouch`](/api/reference/mutations/record-touch)  `mutation`