heyreach-connect

abdullahbeam's avatarfrom abdullahbeam

Connect to HeyReach for LinkedIn automation. Load when user mentions 'heyreach', 'linkedin outreach', 'linkedin campaigns', 'heyreach campaigns', 'add leads', 'campaign stats'. Meta-skill that validates config and routes to operations.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025
[Cold Outreach and Sequences]

When & Why to Use This Skill

The HeyReach Connect skill integrates Claude with the HeyReach platform to streamline LinkedIn automation and B2B lead generation. It empowers users to manage outreach campaigns, track real-time analytics, and handle lead lists through natural language, significantly reducing the manual effort required for LinkedIn prospecting and sales engagement.

Use Cases

  • Campaign Orchestration: Effortlessly list, pause, or resume LinkedIn outreach campaigns and view specific campaign details to ensure sales sequences are running optimally.
  • Lead Pipeline Management: Quickly add new LinkedIn profile URLs to existing campaigns or create new lead lists to maintain a consistent flow of prospects.
  • Performance Monitoring: Access comprehensive campaign statistics and metrics to analyze engagement rates and optimize outreach ROI.
  • Multi-Account Coordination: Manage multiple LinkedIn accounts and monitor conversations across different campaigns from a single interface.
nameheyreach-connect
description"Connect to HeyReach for LinkedIn automation. Load when user mentions 'heyreach', 'linkedin outreach', 'linkedin campaigns', 'heyreach campaigns', 'add leads', 'campaign stats'. Meta-skill that validates config and routes to operations."

HeyReach Connect

Meta-skill for HeyReach LinkedIn automation integration.

Trigger Phrases

  • "heyreach" / "heyreach campaigns"
  • "linkedin outreach" / "linkedin automation"
  • "list campaigns" / "show campaigns"
  • "campaign stats" / "campaign metrics"
  • "add leads to campaign"
  • "campaign leads"
  • "linkedin accounts"

Pre-Flight Check (ALWAYS RUN FIRST)

python 00-system/skills/heyreach/heyreach-master/scripts/check_heyreach_config.py --json
ai_action What to Do
proceed_with_operation Config OK → Continue
prompt_for_api_key Ask user for API key, save to .env

Setup Guide

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
HEYREACH API SETUP
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Log into HeyReach at https://app.heyreach.io
2. Go to Settings → API
3. Copy your API key

Paste your HeyReach API key:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Routing Table

All scripts located in: 00-system/skills/heyreach/heyreach-master/scripts/

User Says Script Args
"list campaigns" list_campaigns.py [--limit N] [--json]
"campaign details [X]" get_campaign.py --campaign-id ID [--json]
"pause/resume [campaign]" toggle_campaign.py --campaign-id ID --status ACTIVE|PAUSED
"add leads to [campaign]" add_leads.py --campaign-id ID --linkedin-urls URLs
"leads in [campaign]" get_leads.py --campaign-id ID [--limit N]
"conversations" get_conversations.py [--campaign-id ID] [--limit N]
"linkedin accounts" list_accounts.py [--json]
"lead lists" list_lists.py [--limit N]
"create list [name]" create_list.py --name NAME
"analytics/stats" get_stats.py [--json]
"metrics for [campaign]" get_metrics.py --campaign-id ID

Example Workflows

List Campaigns

python 00-system/skills/heyreach/heyreach-master/scripts/list_campaigns.py --json

Add Leads

python 00-system/skills/heyreach/heyreach-master/scripts/add_leads.py \
  --campaign-id camp-123 \
  --linkedin-urls "linkedin.com/in/user1,linkedin.com/in/user2"

Get Stats

python 00-system/skills/heyreach/heyreach-master/scripts/get_stats.py --json

Error Handling

Error Solution
401 Invalid API key - re-run setup
403 API not available for subscription
404 Campaign/lead not found
429 Rate limited (auto-retry)

Version: 1.0