---
title: "Push to Instantly"
description: "Send leads straight into an Instantly lead list, keyed on their email. Icebreaker and custom variables included, duplicates flagged, no CSV export."
canonical: "https://derrick-app.com/features/push-to-instantly"
category: "Feature"
runs_on: "Web app, Google Sheets, MCP (AI agents), REST API"
---

# Push to Instantly

> Send leads straight into an Instantly lead list, keyed on their email. Icebreaker and custom variables included, duplicates flagged, no CSV export.

*Canonical: https://derrick-app.com/features/push-to-instantly*

---

## Where it runs

- **Web app** (https://app.derrick-app.com) - nothing to install: import or build a list, add a column with this action, run it.
- **Google Sheets add-on** - run it from the Derrick sidebar, results written to your sheet.
- **MCP server (AI agents)** - call it from Claude, Cursor, or any MCP client. See /mcp.
- **REST API** - call it from your own code (PLUS plan and up). Docs: https://app.derrick-app.com/api-docs

## How to use it

### Step 1: Connect Instantly once
Paste your Instantly API key in Derrick's Connectors. Your lead lists load automatically, and you can create a new one from Derrick.

### Step 2: Map your leads
Pick the list, map the email column (Instantly's lead key), then any fields you have: name, company, job title, website, phone, LinkedIn URL, icebreaker, custom variables.

### Step 3: Push in one click
Every row lands in your Instantly list, ready for a campaign. The pushed and leadId columns confirm each sync; a lead already in the list is flagged, never duplicated.

## Use it from an AI agent (MCP)

Exposed as the `derrick_push_to_instantly` tool on the Derrick MCP server.

**Example prompt**: "Push this lead into my Instantly list"

**Result**: Lead added to your Instantly list.

Install: `claude mcp add derrick -- npx -y derrick-mcp`. Full catalog at /mcp.md.

## Use it from the REST API

Action: `push_to_instantly`. Available from the PLUS plan upward, same credit cost as in the web app and the add-on.

- Docs: https://app.derrick-app.com/api-docs
- Auth: pass your key in the `x-api-key` header (get it at https://app.derrick-app.com/api-mcp, or in the Google Sheets add-on -> menu -> API)
- Machine-readable pricing: /pricing.md

## From data to cold email, zero export
Whatever you built in Derrick, engagers, look-alike companies, verified emails, goes one click into Instantly and into your campaigns.