Skip to main content
POST
Create deal

Authorizations

Authorization
string
header
required

User keys begin with darwin_. Application service-account keys begin with darwin_sa_ and are restricted to linked agents.

Body

application/json
direction
enum<string>
required
Available options:
DEMAND,
SUPPLY
title
string
required
Maximum string length: 160
agentId
string

Required for application service accounts. User keys may omit it to use the selected agent.

goalId
string
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.