> SpecStream is the live web data engine for teams and agents. This is the Markdown copy of https://specstream.ai/docs/integrations/instantly. Every page, with what SpecStream does and costs: https://specstream.ai/llms.txt

# Instantly

Send live web data to an Instantly campaign. SpecStream finds the businesses and people the campaign is for, each value with the page it came from, and every match becomes a lead through Zapier, n8n, Instantly's API, or a CSV file.

[SpecStream for InstantlyOutreach & sales](https://specstream.ai/integrations/instantly.md)

## What you need

-   An Instantly account with a campaign to add leads to.
-   A SpecStream account. New accounts get $10 of work free, with no card.
-   A Zapier account or self-hosted n8n, and a SpecStream API key. The CSV route needs neither.

1.  1

    ## 1. Ask for records Instantly can use

    Instantly needs an email for every lead in a campaign, so ask for one, for example `Roofing companies in Columbus, Ohio, with the owner's name and email and the company website`. SpecStream returns an email only when the business or person published it.

2.  2

    ## 2. Connect SpecStream to Zapier

    Add the SpecStream app to Zapier and connect it with an API key, as the [Zapier guide](https://specstream.ai/docs/integrations/zapier.md) shows.

    Make the key in SpecStream under **Agents & API**, then **API keys**, then **Create API key**. A key that only receives records needs **Read saved requests**, **Read results and their sources**, and **Read account and balance**. Leave **Project** on **All your projects**, because the trigger registers a webhook on your account.

3.  3

    ## 3. Add each record to the campaign

    Start a Zap with SpecStream's **New Row in a Finished List** trigger. Add Instantly's **Add Lead to Campaign** action and pick the campaign.

    Map the email from the record's email column, and the name, company, and website from the columns that hold them. Fields are named the way your list names its columns.

    A record without an email stops at the Instantly step. Put a **Filter by Zapier** step before it that continues only when the email field exists.

4.  4

    ## 4. Keep the campaign current

    For records that arrive over time, start the Zap with **New or Changed Row in a Watched List** instead. In SpecStream, open the list, click **Keep it current**, choose how often it runs, and click **Start monitor**. Each run then sends only the records that are new or changed. [Monitors](https://specstream.ai/docs/schedules.md) covers cadence and limits.

## With n8n

Instantly's node is verified by n8n and installs from the nodes panel. Start a workflow with **SpecStream Trigger** on **Run Completed**, read each record with the SpecStream node's **Get List Results**, and add it with the Instantly node's lead operation that adds a lead to a campaign. The [n8n guide](https://specstream.ai/docs/integrations/n8n.md) covers the SpecStream side.

## From your own code

Instantly's API v2 adds a lead with `POST https://api.instantly.ai/api/v2/leads`, with the campaign's ID in `campaign` and the address in `email`, signed with `Authorization: Bearer` and an Instantly API v2 key. `POST /api/v2/leads/add` takes up to 1,000 leads at once.

Receive SpecStream records with a [webhook](https://specstream.ai/docs/webhooks.md) when a run finishes or a monitor finds something, or read them with the [REST API](https://specstream.ai/docs/api.md).

## With a CSV file

In SpecStream, select the records, click **Export**, and download a CSV. In Instantly, open the campaign, go to **Leads**, upload the CSV, map the columns, and upload. The email column is required. Instantly checks for duplicates on its own.

## Cost

Sending records to Instantly costs nothing on SpecStream's side. SpecStream bills your balance for the records that match a request, never above the maximum you approved, and a request that finds nothing is free. Zapier, n8n, and Instantly bill for their own plans. [Balance, quotes, and billing](https://specstream.ai/docs/billing.md) has the rates.

## More

[SpecStream for Instantly](https://specstream.ai/integrations/instantly.md) covers what it does in Instantly on one page. Every other tool has its guide in [Connect your tools](https://specstream.ai/docs/integrations.md). You see the most a request can cost before it starts, and the matches are paid from your balance. [Billing](https://specstream.ai/docs/billing.md) has the details. For help, email [support@specstream.ai](mailto:support@specstream.ai).