Create Account Deal
POST /accounts/{account_id}/deals
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.
Authorizations
Parameters
Path Parameters
Account the deal belongs to.
Account the deal belongs to.
Header Parameters
Request Body required
Create a deal already attached to an account.
POST /deals creates one standalone. This attaches it in the same call,
which is the difference worth having: a two-step create leaves a window
where the deal exists with no account.
object
Stage NAME, not id.
Responses
201
Successful Response
object
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”.
object
422
Validation Error