Create Opportunity
Create an opportunity. contactId is optional. Unless the location allows duplicate opportunities (allowDuplicateOpportunity), a contact can have only one opportunity per pipeline. Opportunities without a contact are never treated as duplicates. Creating a second opportunity for the same contact in the same pipeline returns 400 with code: OPPORTUNITY_NO_DUPLICATE and the existing opportunity id in meta.existingId.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your access token.
opportunities. writeOAuthPrivate IntegrationSub-Account TokenRequest
Headers
API Version. Send v3.
v3v3Body
pipeline Id
VDm7RPYC2GLUvdpKmBfCIdentifier of the location (sub-account)
ve9EPM428h8vShlRW1KTName of the opportunity, up to 150 characters. A longer name returns 422, unless it is the name already stored.
Possible values: <= 150 characters
First OppsIdentifier of the pipeline stage
7915dedc-8f18-44d5-8bc3-77c04e994a10Current status of the opportunity
openwonlostabandonedopenIdentifier of the contact linked to the opportunity. Optional: an opportunity can be created without a contact. Unless the location allows duplicate opportunities (allowDuplicateOpportunity), a contact can have only one opportunity per pipeline. Opportunities without a contact are never treated as duplicates.
mTkSCb1UBjb5tk4OvB69Monetary value of the opportunity
Possible values: >= 0
220Expected close date. Supported formats: YYYY/MM/DD, MM/DD/YYYY, YYYY-MM-DD, MM-DD-YYYY, YYYY.MM.DD, MM.DD.YYYY, or ISO 8601
2026-04-23Forecast probability
20Identifier of the user the opportunity is assigned to
082goXVW3lIExEQPOnd3Lost reason id (24-character hex) from GET /opportunities/lost-reason. Used only when status is lost, and ignored otherwise. A malformed id returns 400 LOST_REASON_NOT_FOUND; an id that is unknown, deleted or from another location is saved as null.
65f1c2a4e8b9d3f7a2c4e6b8Custom field values to set, each with fieldValue. Identify each field by id or by key (without the opportunity. prefix). Entries that match no opportunity custom field in the location are ignored, not rejected. field_value is the 2021-07-28 name and is ignored in v3.
[
{
"id": "6dvNaf7VhkQ9snc5vnjJ",
"fieldValue": "9039160788"
}
]
Response
Successful response
The created or retrieved opportunity object