Deals

Create Account Deal

Create a deal already attached to an account.

POST /deals creates one standalone; this attaches it in the same call, closing the window where a deal exists with no account.

No per-record gate, matching the app: there is no existing deal to check against, and the account is validated by the handler.

post/accounts/{account_id}/deals

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/accounts/{account_id}/deals
  • Auth: HTTP bearer

Path parameters

account_idstring required

Account the deal belongs to.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

namestring required
descriptionstring nullable
amountnumber nullable
currencystring
stagestring

Stage NAME, not id.

stage_idstring nullable

Stage id. Takes precedence over stage.

pipeline_idstring nullable
productsstring[]
owner_idstring nullable

Who owns the deal. Omit to take the app's default - an API key is an ORGANISATION credential, so there is no 'me' to fall back to.

close_datestring date-time nullable
contact_idsstring[]

Response

Successful Response

dataDealPayload required

An open envelope for a deal, a merge preview or a column result.

Open because the crossfire and merge-preview payloads are computed shapes that grow with the product, and a closed model would drop a field from an ADVISORY read - where a missing signal reads as "nothing to worry about" rather than "we did not tell you".

Changes

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