Add Leads to Campaign

curl -X POST "https://api.foxreach.io/api/v1/campaigns/cmp_abc123/leads" \
  -H "X-API-Key: otr_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "leadIds": ["cld_xyz789", "cld_def456", "cld_ghi012"]
  }'

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
result = client.campaigns.add_leads("cmp_xyz789", ["cld_lead1", "cld_lead2"])

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const result = await client.campaigns.addLeads("cmp_xyz789", ["cld_lead1", "cld_lead2"]);

{
  "data": {
    "added": 2,
    "skipped": 1
  }
}

POST

api

campaigns

{campaign_id}

leads

curl -X POST "https://api.foxreach.io/api/v1/campaigns/cmp_abc123/leads" \
  -H "X-API-Key: otr_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "leadIds": ["cld_xyz789", "cld_def456", "cld_ghi012"]
  }'

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
result = client.campaigns.add_leads("cmp_xyz789", ["cld_lead1", "cld_lead2"])

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const result = await client.campaigns.addLeads("cmp_xyz789", ["cld_lead1", "cld_lead2"]);

{
  "data": {
    "added": 2,
    "skipped": 1
  }
}

Path Parameters

string

required

The unique identifier of the campaign.

Body Parameters

array

required

Array of lead IDs to add to the campaign.

Response

object

Show Result

integer

Number of leads successfully added.

integer

Number of leads skipped (already in campaign or invalid ID).

curl -X POST "https://api.foxreach.io/api/v1/campaigns/cmp_abc123/leads" \
  -H "X-API-Key: otr_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "leadIds": ["cld_xyz789", "cld_def456", "cld_ghi012"]
  }'

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
result = client.campaigns.add_leads("cmp_xyz789", ["cld_lead1", "cld_lead2"])

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const result = await client.campaigns.addLeads("cmp_xyz789", ["cld_lead1", "cld_lead2"]);

{
  "data": {
    "added": 2,
    "skipped": 1
  }
}

Errors

Status	Description
`404`	Campaign not found

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.

List Campaign Leads Remove Lead from Campaign

Leads

Campaigns

Sequences

Campaign Leads

Campaign Accounts

Inbox

Email Accounts

Templates

Analytics

Webhooks API

Path Parameters

Body Parameters

Response

Errors

Rate Limit

​Path Parameters

​Body Parameters

​Response

​Errors

​Rate Limit

Path Parameters

Body Parameters

Response

Errors

Rate Limit