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