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

CreateOpportunityInput

An opportunity to open.

input CreateOpportunityInput {
  agreementSignedOn: Date
  agreementStatus: AgreementStatus
  agreementUrl: String
  companyId: ID!
  currency: String
  exclusiveUntil: Date
  exclusivity: OpportunityExclusivity
  feeBasis: FeeBasis
  feePercent: Decimal
  guaranteeDays: Int
  lostReason: String
  name: String!
  nextStep: String
  nextStepDate: Date
  ownerId: ID
  referredByPersonId: ID
  source: OpportunitySource
  stage: OpportunityStage
  summary: String
}

Fields

CreateOpportunityInput.agreementSignedOn · Date scalar

The day the agreement was signed.

CreateOpportunityInput.agreementStatus · AgreementStatus enum

Where the written agreement stands. NONE when left out.

CreateOpportunityInput.agreementUrl · String scalar

A link to the agreement, as an http or https address.

CreateOpportunityInput.companyId · ID! non-null scalar

The company it is with.

CreateOpportunityInput.currency · String scalar

The currency of its money, as a three-letter ISO 4217 code in upper case. GBP when left out.

CreateOpportunityInput.exclusiveUntil · Date scalar

The last day of exclusivity.

CreateOpportunityInput.exclusivity · OpportunityExclusivity enum

Whether the roles are worked alone. NONE when left out.

CreateOpportunityInput.feeBasis · FeeBasis enum

What the fee is a percentage of. Left out, the company's default.

CreateOpportunityInput.feePercent · Decimal scalar

The fee percentage, from 0 to 100. Left out, the company's default.

CreateOpportunityInput.guaranteeDays · Int scalar

The guarantee in days, 0 or more. Left out, the company's default.

CreateOpportunityInput.lostReason · String scalar

Why it was lost. Required when stage is LOST.

CreateOpportunityInput.name · String! non-null scalar

What to call it, such as Magic: GTM hiring, Nov 2026. From 1 to 300 characters.

CreateOpportunityInput.nextStep · String scalar

What happens next.

CreateOpportunityInput.nextStepDate · Date scalar

The day the next step is due.

CreateOpportunityInput.ownerId · ID scalar

The member who owns it. Must be a member of this workspace.

CreateOpportunityInput.referredByPersonId · ID scalar

The person who referred it.

CreateOpportunityInput.source · OpportunitySource enum

How it came about.

CreateOpportunityInput.stage · OpportunityStage enum

The stage to start at. IDENTIFIED when left out.

CreateOpportunityInput.summary · String scalar

A running account of where it stands.

Member Of

createOpportunity mutation