API ReferenceOpportunity
opportunity.create
Type: Mutation · Auth: Workspace-aware
Input
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| customerId | string | Yes | — | ID of the associated customer |
| primaryContactId | unknown | No | — | ID of the associated primary contact |
| siteId | unknown | No | — | ID of the associated site |
| title | string | Yes | — | Title |
| stage | enum(lead, qualified, survey, proposal, negotiation, won, lost) | Yes | "lead" | Stage |
| pipelineType | enum(new_construction, retrofit, service_agreement, expansion, other) | Yes | — | Pipeline type |
| source | unknown | No | — | Source |
| estimatedValue | unknown | No | — | Estimated value |
| expectedCloseDate | unknown | No | — | Expected close date |
| probability | unknown | No | — | Probability |
| solutionFamilies | string[] | No | — | Solution families |
| scopeSummary | unknown | No | — | Scope summary |
| competitorNotes | unknown | No | — | Competitor notes |
| winLossReason | unknown | No | — | Win loss reason |
| nextStepDescription | unknown | No | — | Next step description |
| nextStepDate | unknown | No | — | Next step date |
| bidDueDate | unknown | No | — | Bid due date |
| budgetConfirmed | boolean | Yes | false | Budget confirmed |
| priority | unknown | No | — | Priority |
| lostReasonCategory | unknown | No | — | Lost reason category |
| technicalRequirements | unknown | No | — | Technical requirements |
| ownerUserId | unknown | No | — | ID of the associated owner user |
| engagementType | enum(direct_to_end_user, subcontracted_by_upstream, prime_with_subcontractors, upstream_and_downstream, service_only, warranty_only, internal, other) | No | "direct_to_end_user" | Engagement type |
| endUserOrganizationId | unknown | No | — | ID of the associated end user organization |
| upstreamOrganizationId | unknown | No | — | ID of the associated upstream organization |
| workspaceId | string | No | — | ID of the associated workspace |
| visibilityMode | unknown | No | — | Visibility mode |
Example
{
"customerId": "550e8400-e29b-41d4-a716-446655440000",
"primaryContactId": null,
"siteId": null,
"title": "Example Title",
"stage": "lead",
"pipelineType": "new_construction",
"budgetConfirmed": false
}