---
title: "Bulk Delete Leads"
method: POST
path: "/api/v1/leads/bulk-delete"
tags: ["leads"]
---

# Bulk Delete Leads

`POST /api/v1/leads/bulk-delete`

## Request

- Base URL: `https://api.nudgelink.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nudgelink.co/api/v1/leads/bulk-delete`
- Auth: HTTP bearer

Delete many leads (and their sequences/messages) in one call. Only the
caller's own leads are touched; unknown / other-tenant ids are ignored.

## Request body

- BulkDeleteLeadsRequest
  - `lead_ids` string[], required

## Response `200`

Successful Response

- BulkDeleteLeadsResponse
  - `deleted` integer, required

## Other responses

- `422`: Validation Error

---

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