# RelationshipSignal (/api/reference/objects/relationship-signal)

A change in a candidate's or a company's situation that gives a recruiter a reason to get in touch: a job move, a promotion, a tenure milestone, a company hiring. This is not the evidence behind a grade: that is `JobCandidateSignal`.

```graphql
type RelationshipSignal {
  actionLabel: String
  actionPath: String
  candidate: Candidate
  detectedAt: DateTime!
  evidence: RelationshipSignalEvidence!
  id: ID!
  kind: RelationshipSignalKind!
  priority: RelationshipSignalPriority!
  recommendedAction: String!
  snoozedUntil: DateTime
  status: RelationshipSignalStatus!
  whatChanged: String!
  whyItMatters: String!
}
```

### Fields [#fields]

#### [`RelationshipSignal.actionLabel`](#action-label) · [`String`](/api/reference/scalars/string) `scalar` [#action-label]
The words for the button that takes the action, such as "Review matches". Null when the signal suggests no step inside the app.

#### [`RelationshipSignal.actionPath`](#action-path) · [`String`](/api/reference/scalars/string) `scalar` [#action-path]
The path inside the app that the action opens, such as `/jobs/12/source`. Null when there is none.

#### [`RelationshipSignal.candidate`](#candidate) · [`Candidate`](/api/reference/objects/candidate) `object` [#candidate]
The candidate it is about. Null for a signal about a company.

#### [`RelationshipSignal.detectedAt`](#detected-at) · [`DateTime!`](/api/reference/scalars/date-time) `non-null` `scalar` [#detected-at]
When Kith ATS first saw the change.

#### [`RelationshipSignal.evidence`](#evidence) · [`RelationshipSignalEvidence!`](/api/reference/objects/relationship-signal-evidence) `non-null` `object` [#evidence]
The facts behind the signal that the app shows beside it.

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

#### [`RelationshipSignal.kind`](#kind) · [`RelationshipSignalKind!`](/api/reference/enums/relationship-signal-kind) `non-null` `enum` [#kind]
What kind of change it is.

#### [`RelationshipSignal.priority`](#priority) · [`RelationshipSignalPriority!`](/api/reference/enums/relationship-signal-priority) `non-null` `enum` [#priority]
How soon it deserves attention.

#### [`RelationshipSignal.recommendedAction`](#recommended-action) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#recommended-action]
What to do about it, in a sentence.

#### [`RelationshipSignal.snoozedUntil`](#snoozed-until) · [`DateTime`](/api/reference/scalars/date-time) `scalar` [#snoozed-until]
When a snoozed signal comes back. Null unless `status` is SNOOZED.

#### [`RelationshipSignal.status`](#status) · [`RelationshipSignalStatus!`](/api/reference/enums/relationship-signal-status) `non-null` `enum` [#status]
Where the signal stands with the workspace.

#### [`RelationshipSignal.whatChanged`](#what-changed) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#what-changed]
What changed, in a sentence.

#### [`RelationshipSignal.whyItMatters`](#why-it-matters) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#why-it-matters]
Why the change matters to this workspace, in a sentence.

### Member Of [#member-of]

[`DismissRelationshipSignalPayload`](/api/reference/objects/dismiss-relationship-signal-payload)  `object` · [`MarkRelationshipSignalActedOnPayload`](/api/reference/objects/mark-relationship-signal-acted-on-payload)  `object` · [`RelationshipSignalEdge`](/api/reference/objects/relationship-signal-edge)  `object` · [`SnoozeRelationshipSignalPayload`](/api/reference/objects/snooze-relationship-signal-payload)  `object`