Skip to main content
POST
Create deal

Authorizations

Authorization
string
header
required

Darwin API keys begin with darwin_ and are created in Developer settings.

Body

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

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

goalId
string
taskId
string
deprecated

Deprecated compatibility alias for goalId.

direction
enum<string>
deprecated

Deprecated compatibility field. Use mode.

Available options:
DEMAND,
SUPPLY
visibility
enum<string>
Available options:
PUBLIC,
RESTRICTED,
PRIVATE
accessPolicyId
string
terms
object
counterparty
object

Response

The new deal.

deal
object
required

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