Delete Lead

DELETE

api

leads

{lead_id}

curl -X DELETE "https://api.foxreach.io/api/v1/leads/cld_abc123" \
  -H "X-API-Key: otr_your_key"

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")

result = client.leads.delete("cld_abc123")

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });

const result = await client.leads.delete("cld_abc123");

{
  "data": {
    "id": "cld_abc123",
    "deleted": true
  }
}

Path Parameters

string

required

The unique identifier of the lead to delete.

Response

Returns a confirmation object.

curl -X DELETE "https://api.foxreach.io/api/v1/leads/cld_abc123" \
  -H "X-API-Key: otr_your_key"

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")

result = client.leads.delete("cld_abc123")

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });

const result = await client.leads.delete("cld_abc123");

{
  "data": {
    "id": "cld_abc123",
    "deleted": true
  }
}

Errors

Status	Description
`404`	Lead not found

This action is permanent and cannot be undone. The lead stops in every campaign it is enrolled in. If the same address is imported again later, it rejoins a campaign the next time that campaign is started or resumed (or when it is added again with POST /campaigns/{campaign_id}/leads), continuing from the step where it stopped. A campaign left with no leads to send is marked completed.

Rate Limit

100 requests per minute, per API key. Fixed 60-second window.
Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (unix epoch seconds).
A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.

curl -X DELETE "https://api.foxreach.io/api/v1/leads/cld_abc123" \
  -H "X-API-Key: otr_your_key"

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")

result = client.leads.delete("cld_abc123")

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });

const result = await client.leads.delete("cld_abc123");

{
  "data": {
    "id": "cld_abc123",
    "deleted": true
  }
}

Getting started

API guides

Leads

Campaigns

Sequences

Campaign Leads

Campaign Accounts

Inbox

Email Accounts

Lead Finder

Tracking Domains

Warmup

Managed Mailboxes

Templates

Analytics

Webhooks API

Path Parameters

Response

Errors

Rate Limit

​Path Parameters

​Response

​Errors

​Rate Limit

Path Parameters

Response

Errors

Rate Limit