Start free trial

Convert a deal into a customer/project/draft order

POST/api/v1/o2c/deals/{deal_id}/create-order

One-way handoff into Order-to-Cash (CreateOrderFromDealService): creates a customer if the deal has none yet, a project beneath it (unique per customer, case-insensitive), and a draft order pre-filled from the deal's estimates -- then freezes the deal by stamping customer_id / project_id / order_id. Atomic: any failure rolls back every write. Fails if the deal has already converted.

Operation ID: create_order_from_deal_api_v1_o2c_deals__deal_id__create_order_post·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Path

deal_idstringrequired

Request body

Schema: DealCreateOrderRequest

project_namestringrequired

Name for the new project created beneath the customer; must be unique (case-insensitively) among the customer's projects.

order_descriptionstring

Order description. Defaults to the deal's name.

Responses

201Successful Response

Schema: SuccessEnvelope_DealCreateOrderResponse_

successboolean
messagestring
codestring
dataDealCreateOrderResponse

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Not Found - Resource does not exist

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError
5 fields
locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject