# CreateOpportunityInput (/api/reference/inputs/create-opportunity-input)

An opportunity to open.

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

#### [`CreateOpportunityInput.agreementSignedOn`](#agreement-signed-on) · [`Date`](/api/reference/scalars/date) `scalar` [#agreement-signed-on]
The day the agreement was signed.

#### [`CreateOpportunityInput.agreementStatus`](#agreement-status) · [`AgreementStatus`](/api/reference/enums/agreement-status) `enum` [#agreement-status]
Where the written agreement stands. `NONE` when left out.

#### [`CreateOpportunityInput.agreementUrl`](#agreement-url) · [`String`](/api/reference/scalars/string) `scalar` [#agreement-url]
A link to the agreement, as an http or https address.

#### [`CreateOpportunityInput.companyId`](#company-id) · [`ID!`](/api/reference/scalars/id) `non-null` `scalar` [#company-id]
The company it is with.

#### [`CreateOpportunityInput.currency`](#currency) · [`String`](/api/reference/scalars/string) `scalar` [#currency]
The currency of its money, as a three-letter ISO 4217 code in upper case. `GBP` when left out.

#### [`CreateOpportunityInput.exclusiveUntil`](#exclusive-until) · [`Date`](/api/reference/scalars/date) `scalar` [#exclusive-until]
The last day of exclusivity.

#### [`CreateOpportunityInput.exclusivity`](#exclusivity) · [`OpportunityExclusivity`](/api/reference/enums/opportunity-exclusivity) `enum` [#exclusivity]
Whether the roles are worked alone. `NONE` when left out.

#### [`CreateOpportunityInput.feeBasis`](#fee-basis) · [`FeeBasis`](/api/reference/enums/fee-basis) `enum` [#fee-basis]
What the fee is a percentage of. Left out, the company's default.

#### [`CreateOpportunityInput.feePercent`](#fee-percent) · [`Decimal`](/api/reference/scalars/decimal) `scalar` [#fee-percent]
The fee percentage, from 0 to 100. Left out, the company's default.

#### [`CreateOpportunityInput.guaranteeDays`](#guarantee-days) · [`Int`](/api/reference/scalars/int) `scalar` [#guarantee-days]
The guarantee in days, 0 or more. Left out, the company's default.

#### [`CreateOpportunityInput.lostReason`](#lost-reason) · [`String`](/api/reference/scalars/string) `scalar` [#lost-reason]
Why it was lost. Required when `stage` is `LOST`.

#### [`CreateOpportunityInput.name`](#name) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#name]
What to call it, such as `Magic: GTM hiring, Nov 2026`. From 1 to 300 characters.

#### [`CreateOpportunityInput.nextStep`](#next-step) · [`String`](/api/reference/scalars/string) `scalar` [#next-step]
What happens next.

#### [`CreateOpportunityInput.nextStepDate`](#next-step-date) · [`Date`](/api/reference/scalars/date) `scalar` [#next-step-date]
The day the next step is due.

#### [`CreateOpportunityInput.ownerId`](#owner-id) · [`ID`](/api/reference/scalars/id) `scalar` [#owner-id]
The member who owns it. Must be a member of this workspace.

#### [`CreateOpportunityInput.referredByPersonId`](#referred-by-person-id) · [`ID`](/api/reference/scalars/id) `scalar` [#referred-by-person-id]
The person who referred it.

#### [`CreateOpportunityInput.source`](#source) · [`OpportunitySource`](/api/reference/enums/opportunity-source) `enum` [#source]
How it came about.

#### [`CreateOpportunityInput.stage`](#stage) · [`OpportunityStage`](/api/reference/enums/opportunity-stage) `enum` [#stage]
The stage to start at. `IDENTIFIED` when left out.

#### [`CreateOpportunityInput.summary`](#summary) · [`String`](/api/reference/scalars/string) `scalar` [#summary]
A running account of where it stands.

### Member Of [#member-of]

[`createOpportunity`](/api/reference/mutations/create-opportunity)  `mutation`