DELETE
/
api
/
v2
/
leads
/
{leadId}
curl --request DELETE \
  --url https://api.buena.ai/api/v2/leads/{leadId} \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "message": "Lead lead_123abc has been successfully deleted"
}

​
Delete Lead

Permanently remove a lead from your database. This action cannot be undone.

This action is irreversible. Make sure you really want to delete this lead before proceeding.

​
Request

​
leadId
string
required

The unique identifier of the lead to delete

​
x-api-key
string
required

Your API key with leads:write permission

​
Examples

​
Delete Lead

curl -X DELETE "https://api.buena.ai/api/v2/leads/lead_123abc" \
  -H "x-api-key: YOUR_API_KEY"

​
Response

​
success
boolean

Always true for successful requests

​
message
string

Confirmation message

{
  "success": true,
  "message": "Lead lead_123abc has been successfully deleted"
}

​
Next Steps

Create Lead

Create a new lead

List Leads

View remaining leads