---
title: "Delete a lead by ID"
method: DELETE
path: "/leads/{id}"
tags: ["Leads"]
---

# Delete a lead by ID

`DELETE /leads/{id}`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/leads/{id}`
- Auth: HTTP bearer

Deletes a lead and all associated unsent emails. If the lead is associated with campaigns, it will be removed from those campaigns first. If the lead has unsubscribed, its email address is added to the workspace's block list (scope workspace) unless it is already there, so importing the address again never emails someone who opted out.

## Path parameters

- `id` integer, required

## Response `200`

Lead deleted successfully

- ModelsDeleteLeadResponse
  - `id` integer
  - `message` string

## Other responses

- `400`: Invalid lead ID
- `401`: Unauthorized - invalid or missing API key
- `403`: Forbidden - lead does not belong to your space
- `404`: Lead not found
- `500`: Failed to delete lead

---

[API](https://skmtc.dev/emailchaser/apis/emailchaser-api.md) · [All operations](https://skmtc.dev/emailchaser/apis/emailchaser-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emailchaser/apis/emailchaser-api/revisions/8b114990abb7?raw)