# Instantly Lead API

**Canonical:** https://apis.io/apis/instantly-ai/instantly-ai-lead-api/  
**Provider:** Instantly — https://apis.io/providers/instantly-ai/  
**Base URL:** https://api.instantly.ai/api/v2  
**Documentation:** https://developer.instantly.ai/api-reference

Instantly Lead API is one of 30 APIs that [Instantly](https://apis.io/providers/instantly-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Lead. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

A lead entity representing an individual lead

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v2/leads` | Create lead |
| DELETE | `/api/v2/leads` | Delete leads in bulk |
| POST | `/api/v2/leads/list` | List leads |
| GET | `/api/v2/leads/{id}` | Get lead |
| PATCH | `/api/v2/leads/{id}` | Patch lead |
| DELETE | `/api/v2/leads/{id}` | Delete lead |
| POST | `/api/v2/leads/merge` | Merge two leads |
| POST | `/api/v2/leads/update-interest-status` | Update the interest status of a lead |
| POST | `/api/v2/leads/subsequence/remove` | Remove a lead from a subsequence |
| POST | `/api/v2/leads/bulk-assign` | Bulk assign leads to organization users |
| POST | `/api/v2/leads/move` | Move leads to a campaign or list |
| POST | `/api/v2/leads/subsequence/move` | Move a lead to a subsequence |
| POST | `/api/v2/leads/add` | Add leads in bulk to a campaign or list |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/instantly-ai/refs/heads/main/openapi/instantly-ai-lead-api-openapi.yml
- **APIReference** — https://developer.instantly.ai/api-reference
- **Documentation** — https://developer.instantly.ai

## Other Instantly APIs (12)

- [Instantly Campaigns API](https://apis.io/apis/instantly-ai/instantly-ai-campaigns-api/)
- [Instantly Account API](https://apis.io/apis/instantly-ai/instantly-ai-account-api/)
- [Instantly Account Campaign Mapping API](https://apis.io/apis/instantly-ai/instantly-ai-accountcampaignmapping-api/)
- [Instantly Analytics API](https://apis.io/apis/instantly-ai/instantly-ai-analytics-api/)
- [Instantly API Key API](https://apis.io/apis/instantly-ai/instantly-ai-apikey-api/)
- [Instantly Audit Log API](https://apis.io/apis/instantly-ai/instantly-ai-auditlog-api/)
- [Instantly Background Job API](https://apis.io/apis/instantly-ai/instantly-ai-backgroundjob-api/)
- [Instantly Block List Entry API](https://apis.io/apis/instantly-ai/instantly-ai-blocklistentry-api/)
- [Instantly Campaign API](https://apis.io/apis/instantly-ai/instantly-ai-campaign-api/)
- [Instantly Campaign Subsequence API](https://apis.io/apis/instantly-ai/instantly-ai-campaignsubsequence-api/)
- [Instantly CRM Actions API](https://apis.io/apis/instantly-ai/instantly-ai-crmactions-api/)
- [Instantly Custom Tag API](https://apis.io/apis/instantly-ai/instantly-ai-customtag-api/)

## Tags

Lead

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/instantly-ai/instantly-ai-lead-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/instantly-ai/.