Skip to main content
POST
/
v1
/
deals
Create Deal
curl --request POST \
  --url https://api.example.com/v1/deals \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "stage": "<string>",
  "status": "<string>",
  "pipeline": "<string>",
  "estimated_value": 123,
  "contact_id": "<string>",
  "owner_id": "<string>",
  "priority": "<string>",
  "deal_type": "<string>",
  "notes": "<string>",
  "tags": [
    {}
  ],
  "description": "<string>",
  "follow_up_date": "<string>",
  "probability": 123,
  "currency": "<string>",
  "related_company_id": "<string>",
  "relationship_partner_id": "<string>",
  "matter_lead_id": "<string>",
  "team_member_ids": [
    {}
  ],
  "fee_model": "<string>"
}
'
{
  "data": {}
}

Request

Body Parameters

name
string
required
Deal name
stage
string
Deal stage name
status
string
default:"active"
Deal status (active, won, lost)
pipeline
string
Pipeline name
estimated_value
number
Estimated deal value
contact_id
string
Primary contact ID (alias for main_contact_id)
owner_id
string
Deal owner user ID (alias for owner_user_id)
priority
string
Priority level
deal_type
string
Deal/matter type (alias for matter_type)
notes
string
Deal notes
tags
array
Array of tag strings
description
string
High-level description
follow_up_date
string
Next follow-up date (ISO 8601)
probability
number
Win probability (0-100)
currency
string
Currency code (e.g., USD, EUR)
Related company ID
relationship_partner_id
string
Relationship partner user ID
matter_lead_id
string
Matter lead user ID
team_member_ids
array
Array of team member user IDs
fee_model
string
Fee/service model

Headers

Authorization: Bearer wbk_your_api_key_here
Content-Type: application/json

Response

data
object
The created deal object with all fields
curl -X POST https://data.leadlex.com/functions/v1/api-gateway/v1/deals \
  -H "Authorization: Bearer wbk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp Partnership",
    "stage": "Proposal",
    "pipeline": "Sales",
    "estimated_value": 50000,
    "contact_id": "contact-001",
    "priority": "high"
  }'

Example Response

{
  "data": {
    "id": "deal-001",
    "name": "Acme Corp Partnership",
    "stage": "Proposal",
    "status": "active",
    "pipeline": "Sales",
    "estimated_value": 50000,
    "main_contact_id": "contact-001",
    "owner_user_id": null,
    "priority": "high",
    "tags": [],
    "created_date": "2026-03-06T10:00:00Z",
    "updated_date": null
  }
}

Errors

StatusCodeDescription
400validation_errorMissing name
403insufficient_permissionsMissing deals:write permission
429rate_limitedRate limit exceeded