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

Opportunity

The commercial agreement to work one or more roles for a company. It exists from the day the company is picked, at stage IDENTIFIED; there is no separate lead record before it. Its terms apply to every job under it.

type Opportunity {
  agreementSignedOn: Date
  agreementStatus: AgreementStatus!
  agreementUrl: String
  company: Company!
  contacts(
    after: String
    before: String
    first: Int
    last: Int
  ): OpportunityContactConnection!
  createdAt: DateTime!
  currency: String!
  exclusiveUntil: Date
  exclusivity: OpportunityExclusivity!
  expectedFee: Decimal
  feeBasis: FeeBasis
  feePercent: Decimal
  fieldValues(
    after: String
    before: String
    first: Int
    last: Int
  ): FieldValueConnection!
  guaranteeDays: Int
  id: ID!
  jobs(
    after: String
    before: String
    first: Int
    last: Int
  ): JobConnection!
  lostReason: String
  name: String!
  nextStep: String
  nextStepDate: Date
  owner: User
  presentations(
    after: String
    before: String
    first: Int
    last: Int
  ): PresentationConnection!
  referredBy: Person
  source: OpportunitySource
  stage: OpportunityStage!
  stageEvents(
    after: String
    before: String
    first: Int
    last: Int
  ): OpportunityStageEventConnection!
  summary: String
  touches(
    after: String
    before: String
    first: Int
    last: Int
  ): TouchConnection!
  updatedAt: DateTime!
}

Fields

Opportunity.agreementSignedOn · Date scalar

The day the agreement was signed.

Opportunity.agreementStatus · AgreementStatus! non-null enum

Where the written agreement stands.

Opportunity.agreementUrl · String scalar

A link to the signed agreement, or to where it is kept.

Opportunity.company · Company! non-null object

The company it is with.

Opportunity.contacts · OpportunityContactConnection! non-null object

Who at the company is involved, and as what, in the order they were added. One person can hold several roles.

Opportunity.contacts.after · String scalar

Return the rows that follow this cursor.

Opportunity.contacts.before · String scalar

Return the rows that come before this cursor.

Opportunity.contacts.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Opportunity.contacts.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Opportunity.createdAt · DateTime! non-null scalar

When it was created.

Opportunity.currency · String! non-null scalar

The currency of its money, as a three-letter ISO 4217 code such as GBP.

Opportunity.exclusiveUntil · Date scalar

The last day of exclusivity, when exclusivity is EXCLUSIVE_UNTIL.

Opportunity.exclusivity · OpportunityExclusivity! non-null enum

Whether the workspace works the roles alone.

Opportunity.expectedFee · Decimal scalar

The sum of its jobs' expected fees, in currency. Worked out by the server; null until a job has a figure.

Opportunity.feeBasis · FeeBasis enum

What feePercent is a percentage of.

Opportunity.feePercent · Decimal scalar

The fee, as a percentage from 0 to 100. A new opportunity takes the company's default when it names none.

Opportunity.fieldValues · FieldValueConnection! non-null object

The workspace's own fields that have a value on it, in the order they were first set.

Opportunity.fieldValues.after · String scalar

Return the rows that follow this cursor.

Opportunity.fieldValues.before · String scalar

Return the rows that come before this cursor.

Opportunity.fieldValues.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Opportunity.fieldValues.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Opportunity.guaranteeDays · Int scalar

How many days of guarantee each placement carries.

Opportunity.id · ID! non-null scalar

The opportunity's id.

Opportunity.jobs · JobConnection! non-null object

The jobs worked under it, in the order they were created.

Opportunity.jobs.after · String scalar

Return the rows that follow this cursor.

Opportunity.jobs.before · String scalar

Return the rows that come before this cursor.

Opportunity.jobs.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Opportunity.jobs.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Opportunity.lostReason · String scalar

Why it was lost. Always set once the stage is LOST.

Opportunity.name · String! non-null scalar

What it is called, such as Magic: GTM hiring, Nov 2026.

Opportunity.nextStep · String scalar

What happens next, in words.

Opportunity.nextStepDate · Date scalar

The day nextStep is due.

Opportunity.owner · User object

The member who owns it. Null when nobody does, or they have left the workspace.

Opportunity.presentations · PresentationConnection! non-null object

The candidates shown to its buyers, newest recorded first.

Opportunity.presentations.after · String scalar

Return the rows that follow this cursor.

Opportunity.presentations.before · String scalar

Return the rows that come before this cursor.

Opportunity.presentations.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Opportunity.presentations.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Opportunity.referredBy · Person object

The person who referred it.

Opportunity.source · OpportunitySource enum

How it came about.

Opportunity.stage · OpportunityStage! non-null enum

How far it has got.

Opportunity.stageEvents · OpportunityStageEventConnection! non-null object

Every stage it has been given: the stage it was created at, then each change, with who made it. Newest first. Two changes in one request share a time, so the order is by id, not by createdAt.

Opportunity.stageEvents.after · String scalar

Return the rows that follow this cursor.

Opportunity.stageEvents.before · String scalar

Return the rows that come before this cursor.

Opportunity.stageEvents.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Opportunity.stageEvents.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Opportunity.summary · String scalar

A running account of where it stands.

Opportunity.touches · TouchConnection! non-null object

The messages, calls and meetings that belong to it, newest recorded first.

Opportunity.touches.after · String scalar

Return the rows that follow this cursor.

Opportunity.touches.before · String scalar

Return the rows that come before this cursor.

Opportunity.touches.first · Int scalar

How many rows to return, from the start or from after. 50 when left out, 200 at most.

Opportunity.touches.last · Int scalar

How many rows to return, counting back from the end or from before. 200 at most.

Opportunity.updatedAt · DateTime! non-null scalar

When it last changed.

Returned By

opportunity query

Member Of

AcceptChangeSuggestionPayload object · AddOpportunityContactPayload object · ChangeSuggestion object · CreateOpportunityPayload object · FieldValue object · Job object · MoveOpportunityStagePayload object · OpportunityEdge object · Presentation object · RemoveOpportunityContactPayload object · SetJobOpportunityPayload object · Touch object · UpdateOpportunityPayload object

On this page

FieldsOpportunity.agreementSignedOn · Date scalarOpportunity.agreementStatus · AgreementStatus! non-null enumOpportunity.agreementUrl · String scalarOpportunity.company · Company! non-null objectOpportunity.contacts · OpportunityContactConnection! non-null objectOpportunity.contacts.after · String scalarOpportunity.contacts.before · String scalarOpportunity.contacts.first · Int scalarOpportunity.contacts.last · Int scalarOpportunity.createdAt · DateTime! non-null scalarOpportunity.currency · String! non-null scalarOpportunity.exclusiveUntil · Date scalarOpportunity.exclusivity · OpportunityExclusivity! non-null enumOpportunity.expectedFee · Decimal scalarOpportunity.feeBasis · FeeBasis enumOpportunity.feePercent · Decimal scalarOpportunity.fieldValues · FieldValueConnection! non-null objectOpportunity.fieldValues.after · String scalarOpportunity.fieldValues.before · String scalarOpportunity.fieldValues.first · Int scalarOpportunity.fieldValues.last · Int scalarOpportunity.guaranteeDays · Int scalarOpportunity.id · ID! non-null scalarOpportunity.jobs · JobConnection! non-null objectOpportunity.jobs.after · String scalarOpportunity.jobs.before · String scalarOpportunity.jobs.first · Int scalarOpportunity.jobs.last · Int scalarOpportunity.lostReason · String scalarOpportunity.name · String! non-null scalarOpportunity.nextStep · String scalarOpportunity.nextStepDate · Date scalarOpportunity.owner · User objectOpportunity.presentations · PresentationConnection! non-null objectOpportunity.presentations.after · String scalarOpportunity.presentations.before · String scalarOpportunity.presentations.first · Int scalarOpportunity.presentations.last · Int scalarOpportunity.referredBy · Person objectOpportunity.source · OpportunitySource enumOpportunity.stage · OpportunityStage! non-null enumOpportunity.stageEvents · OpportunityStageEventConnection! non-null objectOpportunity.stageEvents.after · String scalarOpportunity.stageEvents.before · String scalarOpportunity.stageEvents.first · Int scalarOpportunity.stageEvents.last · Int scalarOpportunity.summary · String scalarOpportunity.touches · TouchConnection! non-null objectOpportunity.touches.after · String scalarOpportunity.touches.before · String scalarOpportunity.touches.first · Int scalarOpportunity.touches.last · Int scalarOpportunity.updatedAt · DateTime! non-null scalarReturned ByMember Of