Delete Lead
curl --request DELETE \
--url https://api.buena.ai/api/v2/leads/{leadId} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.buena.ai/api/v2/leads/{leadId}"
headers = {"x-api-key": "<api-key>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.buena.ai/api/v2/leads/{leadId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.buena.ai/api/v2/leads/{leadId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.buena.ai/api/v2/leads/{leadId}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.buena.ai/api/v2/leads/{leadId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.buena.ai/api/v2/leads/{leadId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Lead lead_123abc has been successfully deleted"
}
Lead Management
Delete Lead
Permanently delete a lead from your database
DELETE
/
api
/
v2
/
leads
/
{leadId}
Delete Lead
curl --request DELETE \
--url https://api.buena.ai/api/v2/leads/{leadId} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.buena.ai/api/v2/leads/{leadId}"
headers = {"x-api-key": "<api-key>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.buena.ai/api/v2/leads/{leadId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.buena.ai/api/v2/leads/{leadId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.buena.ai/api/v2/leads/{leadId}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.buena.ai/api/v2/leads/{leadId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.buena.ai/api/v2/leads/{leadId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
The unique identifier of the lead to delete
Your API key with
leads:write permissionExamples
Delete Lead
curl -X DELETE "https://api.buena.ai/api/v2/leads/lead_123abc" \
-H "x-api-key: YOUR_API_KEY"
const response = await fetch("https://api.buena.ai/api/v2/leads/lead_123abc", {
method: "DELETE",
headers: {
"x-api-key": "YOUR_API_KEY",
},
});
const data = await response.json();
console.log(data);
import requests
response = requests.delete(
'https://api.buena.ai/api/v2/leads/lead_123abc',
headers={
'x-api-key': 'YOUR_API_KEY'
}
)
print(response.json())
Response
Always
true for successful requestsConfirmation message
{
"success": true,
"message": "Lead lead_123abc has been successfully deleted"
}
Next Steps
Create Lead
Create a new lead
List Leads
View remaining leads
⌘I

