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

# Push to HeyReach

> Send leads straight into a HeyReach lead list, keyed on their LinkedIn URL. Icebreaker and custom variables included, no CSV export.

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

---

## 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 HeyReach once
Paste your HeyReach 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 LinkedIn profile URL (HeyReach's lead key), first name and last name, then any fields you have: company, job title, email, icebreaker, custom variables.

### Step 3: Push in one click
Every row lands in your HeyReach list, ready for a LinkedIn campaign. The pushed and result columns tell you if the lead was added or updated.

## Use it from an AI agent (MCP)

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

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

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

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

## Use it from the REST API

Action: `push_to_heyreach`. 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 LinkedIn outreach, zero export
Whatever you built in Derrick, engagers, look-alike companies, enriched leads, goes one click into HeyReach and into your LinkedIn campaigns.