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

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

#### [`Touch.author`](#author) · [`User`](/api/reference/objects/user) `object` [#author]
The member who sent or took it. Null when it was someone who is not a member, or they have left.

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

#### [`Touch.body`](#body) · [`String`](/api/reference/scalars/string) `scalar` [#body]
The message as sent or received, or the summary of a call or meeting.

#### [`Touch.candidate`](#candidate) · [`Candidate`](/api/reference/objects/candidate) `object` [#candidate]
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`](#channel) · [`TouchChannel!`](/api/reference/enums/touch-channel) `non-null` `enum` [#channel]
How it happened.

#### [`Touch.clientContact`](#client-contact) · [`ClientContact`](/api/reference/objects/client-contact) `object` [#client-contact]
The client contact they were touched as, when the writer named one.

#### [`Touch.company`](#company) · [`Company`](/api/reference/objects/company) `object` [#company]
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`](#created-at) · [`DateTime!`](/api/reference/scalars/date-time) `non-null` `scalar` [#created-at]
When the touch was recorded.

#### [`Touch.direction`](#direction) · [`TouchDirection!`](/api/reference/enums/touch-direction) `non-null` `enum` [#direction]
Whether the workspace sent it or received it.

#### [`Touch.externalId`](#external-id) · [`String`](/api/reference/scalars/string) `scalar` [#external-id]
That system's id for the message. The same id from the same system is stored once per person.

#### [`Touch.externalSource`](#external-source) · [`String`](/api/reference/scalars/string) `scalar` [#external-source]
The system a synced touch came from, such as `heyreach` or `gmail`.

#### [`Touch.externalThreadId`](#external-thread-id) · [`String`](/api/reference/scalars/string) `scalar` [#external-thread-id]
The source system’s conversation id, when this touch belongs to a thread.

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

#### [`Touch.job`](#job) · [`Job`](/api/reference/objects/job) `object` [#job]
The job it was about.

#### [`Touch.occurredAt`](#occurred-at) · [`DateTime!`](/api/reference/scalars/date-time) `non-null` `scalar` [#occurred-at]
When it happened, which may be long before it was recorded.

#### [`Touch.opportunity`](#opportunity) · [`Opportunity`](/api/reference/objects/opportunity) `object` [#opportunity]
The opportunity it belongs to.

#### [`Touch.person`](#person) · [`Person!`](/api/reference/objects/person) `non-null` `object` [#person]
Who it was with.

#### [`Touch.transcriptUrl`](#transcript-url) · [`String`](/api/reference/scalars/string) `scalar` [#transcript-url]
A link to the transcript when it is kept somewhere else.

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

### Returned By [#returned-by]

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

### Member Of [#member-of]

[`ChangeSuggestionEvidence`](/api/reference/objects/change-suggestion-evidence)  `object` · [`FieldValue`](/api/reference/objects/field-value)  `object` · [`Presentation`](/api/reference/objects/presentation)  `object` · [`RecordTouchPayload`](/api/reference/objects/record-touch-payload)  `object` · [`TouchEdge`](/api/reference/objects/touch-edge)  `object` · [`UpdateTouchPayload`](/api/reference/objects/update-touch-payload)  `object`