Instantly API docs: automate cold email at scale

Cold email at scale is a pipeline problem. You have leads flowing in from scrapers, enrichment tools, and CRM exports. You need those leads warming in sequences, responses routed to the right closer, and bounces cleaned automatically — without a human copy-pasting between tabs. The Instantly API makes this programmable, turning what's usually a clicky UI workflow into something your infrastructure can orchestrate. According to Instantly's 2024 growth report, the platform manages over 5 million outreach emails daily across 100,000+ accounts — and their API handles a growing share of that volume.

This guide breaks down the Instantly API docs, shows practical integration patterns, and demonstrates how CodeWords can orchestrate multi-step outreach workflows end-to-end.

TL;DR

• The Instantly API provides RESTful endpoints for campaigns, leads, accounts, and analytics — enabling full programmatic control over outreach.
• Key workflows: bulk lead upload, campaign status monitoring, reply detection, and automatic CRM sync.
• Unlike generic AI automation posts, this guide shows real CodeWords workflows — not just theory.

What does the Instantly API actually expose?

The Instantly API docs organize endpoints around four core resources: Campaigns, Leads, Accounts, and Analytics. Authentication uses a simple API key passed as a query parameter. Rate limits are 10 requests per second by default.

How do you upload leads to Instantly via API?

The lead upload endpoint accepts arrays of up to 5,000 leads per request with custom variables that map to merge tags in your email templates.

How do you monitor campaigns and detect replies?

Combine the Instantly API with a CodeWords scheduled workflow: poll leads with replied status, fetch reply content, classify intent with LLM analysis, and route to appropriate next steps. Campaigns that respond to positive replies within 30 minutes see 3x higher conversion to meetings.

How do you build a full outreach pipeline with CodeWords?

A CodeWords workflow chains: Lead sourcing → Enrichment → Upload → Monitoring → CRM sync. CodeWords provides 500+ integrations and runs serverless Python in ephemeral sandboxes, handling secrets and execution environment without infrastructure overhead.

What are the Instantly API limitations you should know?

• No webhook support — you must poll for status changes
• Campaign creation via API is limited — template editing is more reliable through the UI
• Rate limits on analytics — the summary endpoint can lag 5-15 minutes
• Workspace-level deduplication via skip_if_in_workspace

FAQs

Does the Instantly API support sending emails directly?
No. The API manages campaigns, leads, and accounts — actual sending happens through Instantly's infrastructure on their schedule.

Can I use the Instantly API with a free plan?
The Growth plan ($30/month per sending account) includes API access.

How do I handle Instantly API errors in production?
Implement exponential backoff for 429 responses and build retry logic into your CodeWords workflows.

Build your first outreach automation on CodeWords.