Remove Lead from Campaign

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

{
  "data": {
    "removed": true
  }
}

DELETE

api

campaigns

{campaign_id}

leads

{lead_id}

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

{
  "data": {
    "removed": true
  }
}

Path Parameters

campaign_id

string

required

The unique identifier of the campaign.

lead_id

string

required

The unique identifier of the lead to remove.

Returns a confirmation of removal.

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

{
  "data": {
    "removed": true
  }
}

Status	Description
`400`	Cannot remove leads from an active campaign
`404`	Lead not found in campaign
`404`	Campaign not found

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.