Delete Deal

curl --request DELETE \
  --url https://api.example.com/v1/deals/{id}

{
  "data": {
    "deleted": true,
    "id": "<string>"
  }
}

DELETE

deals

{id}

Delete Deal

curl --request DELETE \
  --url https://api.example.com/v1/deals/{id}

{
  "data": {
    "deleted": true,
    "id": "<string>"
  }
}

Request

Path Parameters

string

required

The deal’s unique ID (UUID)

Headers

Authorization: Bearer wbk_your_api_key_here

Requires an API key with the deals:write permission.

Deletion is permanent and cannot be undone. Activities, tasks, and notes linked to this deal become orphaned (their deal_id is set to null) but are not deleted. Fires the deal.deleted webhook event.

Response

data

object

Show properties

deleted

boolean

Always true on success

string

ID of the deleted deal

curl -X DELETE https://data.leadlex.com/functions/v1/api-gateway/v1/deals/3f8e1d2c-4b5a-6d7e-8f9a-0b1c2d3e4f5a \
  -H "Authorization: Bearer wbk_your_api_key_here"

Example Response

{
  "data": {
    "deleted": true,
    "id": "3f8e1d2c-4b5a-6d7e-8f9a-0b1c2d3e4f5a"
  }
}

Errors

Status	Code	Description
401	`invalid_key`	Invalid or expired API key
403	`insufficient_permissions`	Missing `deals:write` permission
404	`deal_not_found`	No deal with this ID in your workspace
429	`rate_limited`	Rate limit exceeded

Update Deal Bulk Create Deals

​Request

​Path Parameters

​Headers

​Response

​Example Response

​Errors

Request

Path Parameters

Headers

Response

Example Response

Errors