heyreach-connect

Automates LinkedIn outreach campaigns through the HeyReach API with config validation and operation routing.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill heyreach-connect-fahadimdad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heyreach-connect
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/heyreach/heyreach-connect
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill heyreach-connect-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing LinkedIn outreach campaigns manually through the HeyReach web interface is slow and repetitive. This Skill connects Claude directly to the HeyReach API so you can list campaigns, add leads, check stats, and manage accounts using natural language commands. ## Core Features & Use Cases - Config Pre-Flight Check: Validates your HeyReach API key before any operation and guides you through setup if missing. - Campaign Operations: List campaigns, get campaign details, pause or resume campaigns, and view per-campaign metrics. - Lead & List Management: Add leads to campaigns by LinkedIn URL, view campaign leads, create lead lists, and inspect conversations. - Use Case: A sales rep says "add these leads to my Q3 campaign" and the Skill routes to the add_leads script with the correct campaign ID and LinkedIn URLs, returning structured JSON results. ## Quick Start Say "list my heyreach campaigns" to connect to HeyReach and see all your LinkedIn outreach campaigns with their current status.

Frequently Asked Questions about heyreach-connect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect HeyReach to Claude for LinkedIn automation?

Copy your API key from HeyReach Settings → API at app.heyreach.io, then provide it when prompted. The Skill runs a pre-flight config check that validates the key and saves it to your .env file before any operation.

How do I add leads to a HeyReach campaign?

Say "add leads to [campaign]" and the Skill runs add_leads.py with the campaign ID and a comma-separated list of LinkedIn profile URLs. The leads are added to the specified campaign via the HeyReach API.

What HeyReach operations can I run with this integration?

You can list campaigns, get campaign details, pause or resume campaigns, add and view leads, list LinkedIn accounts, create lead lists, view conversations, and retrieve campaign stats and metrics.

Why am I getting a 401 error from the HeyReach API?

A 401 error means your API key is invalid or expired. Re-run the setup flow by providing a fresh API key from HeyReach Settings → API, and the Skill will update your .env configuration.

Does the HeyReach integration handle rate limits?

Yes, 429 rate limit responses are handled with automatic retry logic. A 403 error indicates the API is not available for your HeyReach subscription tier, and 404 means the campaign or lead was not found.