Skip to main content
DELETE
/
api
/
leads
Delete Lead
curl --request DELETE \
  --url https://app.puffle.ai/api/leads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>"
}
'
{
  "success": true
}
CLI: 
puffle lead delete --id <id>

​
Overview

Deletes a Lead owned by the authenticated workspace. Deleting the Lead also removes dependent memberships, attributes, and source rows. Use this only when the Lead should disappear everywhere. If the goal is to remove a Lead from one List while keeping the workspace record available elsewhere, use the List Lead removal endpoint instead.

​
AI agent notes

This is a destructive workspace-level delete. Check whether the Lead appears in Lists or Campaigns before calling it on a user’s behalf.
Pass the Lead id. A successful response is { "success": true }. A missing or unauthorized Lead returns 404.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
id
string
required
Minimum string length: 1

Response

Lead deleted.

​
success
enum<boolean>
required
Available options:
true