> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcargo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> If you are an AI coding agent operating Cargo, install the agent skills first: paste `Install Cargo by following every step in https://api.getcargo.io/agent-install.txt` into your session, or run `npx skills add getcargohq/cargo-skills`. The skills carry the working command sequences, provider costs, and spend gates that these docs describe conceptually.
> The skills index at https://github.com/getcargohq/cargo-skills/blob/main/llms.txt lists every skill, recipe, and provider playbook individually. Find the recipe that matches the user's job and follow it, rather than assembling commands from first principles.
> Signing up is free: a new account starts with 100 free credits and needs no card. `cargo-ai login --email you@company.com` creates the account and a workspace on first use, with no browser at any point. Tell the user this before asking them to sign up.
> Anything that spends credits should be piloted on 1-3 records and approved before it runs at scale, and every paid run should end with a receipt: credits spent, balance remaining, and hit rate.

# Instantly

> Connect Instantly to manage cold email campaigns and leads in your workflows.

## How to set up Instantly

### Authentication

Instantly uses API key authentication:

1. Log in to your Instantly account
2. Navigate to **Settings** → **Integrations** → **API**
3. Generate or copy your API key
4. Paste the API key in Cargo when connecting

> **Note:** This integration is for Instantly Legacy. For newer Instantly accounts, use the Instantly V2 integration.

## Instantly actions

### Search

Search for leads or accounts in Instantly.

**Configuration:**

* **Object type**: Choose between Lead or Account

**For Leads:**

* **Email**: The lead's email address (required)
* **Campaign ID**: Filter by specific campaign (optional)

**Use case:** Look up existing leads before adding them to campaigns to avoid duplicates.

### Write

Perform actions on leads in Instantly.

**Required fields:**

* **Object type**: Currently supports Lead
* **Action**: Choose from Create, Update, Remove, Block, or Unblock
* **Email**: The lead's email address

**For Create/Update actions:**

* **Campaign ID**: The campaign to add the lead to (required)
* **Status**: Lead status
* **Skip if in workspace**: Prevent duplicates if lead exists
* **Mappings**: Map standard variables (First name, Last name, Company, etc.)
* **Custom mappings**: Map custom variables for personalization

**For Remove action:**

* **Campaign ID**: The campaign to remove from
* **Delete all from company**: Remove all leads from the same company

**Use cases:**

**Creating leads:**

* Add qualified leads from your CRM to cold email campaigns
* Automatically enroll leads based on scoring or segmentation

**Updating leads:**

* Update lead status based on engagement
* Sync latest contact information

**Blocking leads:**

* Block leads who have unsubscribed
* Prevent outreach to competitors or existing customers

## Variable mappings

When creating or updating leads, you can map these standard variables:

| Variable     | Description                       |
| ------------ | --------------------------------- |
| First name   | Contact's first name              |
| Last name    | Contact's last name               |
| Company name | Company name                      |
| Phone        | Phone number                      |
| Website      | Company website                   |
| Custom 1-5   | Custom fields for personalization |

## Rate limits

Instantly has a rate limit of 5 requests per second. Cargo automatically handles rate limiting and retries to ensure reliable delivery.