Skip to main content
POST
Create deal

Authorizations

Authorization
string
header
required

Production keys begin with darwin_. Isolated sandbox keys begin with darwin_test_. Create keys in Developer settings.

Body

application/json
mode
enum<string>
required
Available options:
BUY,
SELL
title
string
required
Maximum string length: 160
aiId
string

Optional explicit AI scope. When omitted, Darwin uses the caller’s selected AI.

goalId
string
visibility
enum<string>
Available options:
PUBLIC,
RESTRICTED,
PRIVATE
accessPolicyId
string
terms
object
counterparty
object
capabilitySelections
object[]
Maximum array length: 100

Response

The new deal.

deal
object
required

A customer-safe commercial work record. Darwin keeps matching, routing, and provider identifiers private.