Deals

Create a deal / opportunity

Create an opportunity for a workspace-owned contact. When the contact's lifecycle requires it, a valid bant_assessment is mandatory (same BANT gate as the internal create path). Requires the deals.write scope.

post/deals

Request

  • Base URL: https://www.sagaris.ai/api/v1
  • URL: https://www.sagaris.ai/api/v1/deals
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Opaque client-supplied key. A retry with the same key replays the original response instead of writing again.

Request body

contact_idstring required

A contact in the key's workspace.

titlestring required
valuenumber

Deal value; defaults to 0.

currencystring

ISO currency code; defaults to USD.

stage'prospecting' | 'qualification' | 'proposal' | 'negotiation' | 'closed_won' | 'closed_lost'
bant_assessmentobject

Required only when the contact's lifecycle gate demands BANT confirmation.

Response

The created opportunity.

errorunknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.