Iby Instantly
Add leads to a campaign
Adds up to 1,000 leads to one Instantly campaign or lead list, checking their emails against blocklists and existing leads.
Updated Oct 11, 2026
add-leads-to-campaign.md
Add leads to a campaign
Adds up to 1,000 leads to one Instantly campaign or lead list, checking their emails against blocklists and existing leads.
Note: Leads added to an active campaign can start receiving its emails: confirm the campaign first. Pass campaign_id or list_id, not both; the key needs the leads:create scope.
Set up
Use the first option your agent supports.
API (official)
- Base URL: https://api.instantly.ai
- Endpoint:
POST /api/v2/leads/add - Auth: send the header
Authorization: Bearer $INSTANTLY_API_KEY - Get a key: https://app.instantly.ai/app/settings/integrations
- Docs: https://developer.instantly.ai/getting-started/authorization
Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.
Rules
- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.
Ways in
| Route | Source | Call | Required | Docs |
|---|---|---|---|---|
| Official | POST /api/v2/leads/add | API key in $INSTANTLY_API_KEY | Docs |
Workflows using Add leads to a campaign
TContributed by thedogwiththedataonitTurn referral and out-of-office replies into new leadsFinds Instantly replies that name someone else or say the lead left, finds the person's email with Hunter, and adds them to a campaign.
I
T
H
PContributed by philsoerensenHow Brew books 20 demos per week with outboundRuns cold email and LinkedIn as one system, opens with finished work for each prospect, and steers every warm reply to one next step.
CI
B+1