const options = {
method: "DELETE",
headers: {
"x-api-key": "<your-api-key>",
},
};
fetch(
"https://api-v2.getomni.ai/api/v1/leads/b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e",
options
)
.then((response) => response.json())
.then((response) => console.log(response))
.catch((err) => console.error(err));
import requests
lead_id = "b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e"
url = f"https://api-v2.getomni.ai/api/v1/leads/{lead_id}"
headers = {
"x-api-key": "<your-api-key>",
}
response = requests.delete(url, headers=headers)
print(response.json())
curl --request DELETE \
--url 'https://api-v2.getomni.ai/api/v1/leads/b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e' \
--header 'x-api-key: <your-api-key>'
{
"deletedLead": {
"deletedAt": "2026-10-06T21:00:00.000Z",
"id": "b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e",
"name": "John Francisco"
},
"message": "Lead deleted successfully",
"success": true
}
{
"error": "Lead not found",
"success": false
}
Leads
Delete Lead
Delete a lead and stop all pending outreach
DELETE
/
api
/
v1
/
leads
/
{leadId}
const options = {
method: "DELETE",
headers: {
"x-api-key": "<your-api-key>",
},
};
fetch(
"https://api-v2.getomni.ai/api/v1/leads/b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e",
options
)
.then((response) => response.json())
.then((response) => console.log(response))
.catch((err) => console.error(err));
import requests
lead_id = "b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e"
url = f"https://api-v2.getomni.ai/api/v1/leads/{lead_id}"
headers = {
"x-api-key": "<your-api-key>",
}
response = requests.delete(url, headers=headers)
print(response.json())
curl --request DELETE \
--url 'https://api-v2.getomni.ai/api/v1/leads/b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e' \
--header 'x-api-key: <your-api-key>'
{
"deletedLead": {
"deletedAt": "2026-10-06T21:00:00.000Z",
"id": "b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e",
"name": "John Francisco"
},
"message": "Lead deleted successfully",
"success": true
}
{
"error": "Lead not found",
"success": false
}
This endpoint deletes a lead by its
leadId. Deleting a lead removes it from lead lists and lookups, cancels any pending follow-ups and scheduled messages, and removes checklist items that were added specifically to this lead.
Deleted leads can no longer be fetched or updated through the API. Deleting a lead that has already been deleted returns a 404.
Authentication
Requires thex-api-key header with a valid workspace API key.
Path Parameters
string
required
The Monumint lead ID to delete.
Response
boolean
Whether the request succeeded
string
Confirmation message
object
const options = {
method: "DELETE",
headers: {
"x-api-key": "<your-api-key>",
},
};
fetch(
"https://api-v2.getomni.ai/api/v1/leads/b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e",
options
)
.then((response) => response.json())
.then((response) => console.log(response))
.catch((err) => console.error(err));
import requests
lead_id = "b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e"
url = f"https://api-v2.getomni.ai/api/v1/leads/{lead_id}"
headers = {
"x-api-key": "<your-api-key>",
}
response = requests.delete(url, headers=headers)
print(response.json())
curl --request DELETE \
--url 'https://api-v2.getomni.ai/api/v1/leads/b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e' \
--header 'x-api-key: <your-api-key>'
{
"deletedLead": {
"deletedAt": "2026-10-06T21:00:00.000Z",
"id": "b3f1c2d4-5e6a-7b8c-9d0e-1f2a3b4c5d6e",
"name": "John Francisco"
},
"message": "Lead deleted successfully",
"success": true
}
{
"error": "Lead not found",
"success": false
}