Public API Reference (Beta)OpportunitiesCore

Create an opportunity

Creates a new sales opportunity linked to an existing client. Required fields for creation: name, clientGuid, stageName, typeName. If closeProbability is omitted, it defaults to the stage’s configured probability. The authenticated user is automatically assigned as the primary sales representative. Requires the Manage My Opportunities or Manage Any Opportunities permission.

Authentication

X-Brightmove-Company-ApiKeystring
BrightMove Company Api Key
X-Brightmove-User-ApiKeystring
BrightMove User Api Key

Request

This endpoint expects an object.
namestringRequired
Name of the opportunity.
clientGuidstringRequired

GUID of the client (company) to associate with this opportunity.

stageNamestringRequired
Stage name exactly as returned by the GET endpoint. Must match an existing stage configured for your company.
typeNamestringRequired
Opportunity type name exactly as returned by the GET endpoint. Must match an existing type configured for your company.
descriptionstringOptional
Detailed description of the opportunity and its objectives.
opportunityValuedoubleOptional
Estimated total deal value in USD.
closeProbabilitydoubleOptional
Estimated probability of closing this opportunity, expressed as a percentage from 0 to 100. Defaults to the stage's configured probability if omitted.
leadSourceNamestringOptional
Lead source name exactly as returned by the GET endpoint. Must match an existing lead source configured for your company.

Response

Opportunity created successfully