heyreach-connect

name	heyreach-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