---

name: heyreach description: "HeyReach LinkedIn automation integration. Load when user mentions 'heyreach', 'linkedin outreach', 'linkedin campaigns', 'list campaigns', 'add leads', 'campaign stats', or any LinkedIn automation operations."

HeyReach Integration

Complete integration for HeyReach LinkedIn automation platform.

Trigger Phrases

Load this skill when user mentions:

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

---

Pre-Flight Check (ALWAYS RUN FIRST)

Before ANY operation, validate configuration:

Copypython 00-system/skills/heyreach/heyreach-master/scripts/check_heyreach_config.py --json

Handle Config Status

If Setup Needed

CopyI need to set up HeyReach integration first.

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

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

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

After user provides key, add to .env:

CopyHEYREACH_API_KEY=their-key-here

---

Scripts Reference

All scripts are in 00-system/skills/heyreach/heyreach-master/scripts/

Campaign Operations

list_campaigns.py - List all campaigns

Copypython list_campaigns.py [--limit N] [--offset N] [--json]

Trigger: "list campaigns", "show campaigns", "my campaigns"

---

get_campaign.py - Get campaign details

Copypython get_campaign.py --campaign-id ID [--json]

Trigger: "campaign details", "show campaign [name]"

---

toggle_campaign.py - Pause/resume campaign

Copypython toggle_campaign.py --campaign-id ID --status ACTIVE|PAUSED [--json]

Trigger: "pause campaign", "resume campaign", "start/stop campaign"

---

Lead Operations

add_leads.py - Add leads to campaign

Copypython add_leads.py --campaign-id ID --linkedin-urls URL1,URL2 [--json]
python add_leads.py --campaign-id ID --leads '[{"linkedInUrl":"..."}]' [--json]

Trigger: "add leads", "add to campaign", "import leads"

---

get_leads.py - Get campaign leads

Copypython get_leads.py --campaign-id ID [--limit N] [--json]

Trigger: "campaign leads", "show leads", "list leads"

---

Conversation Operations

get_conversations.py - Get message threads

Copypython get_conversations.py [--campaign-id ID] [--limit N] [--json]

Trigger: "conversations", "messages", "inbox", "replies"

---

LinkedIn Account Operations

list_accounts.py - List connected accounts

Copypython list_accounts.py [--json]

Trigger: "linkedin accounts", "connected accounts", "my accounts"

---

List Operations

list_lists.py - List lead lists

Copypython list_lists.py [--limit N] [--json]

Trigger: "lead lists", "show lists", "my lists"

---

create_list.py - Create lead list

Copypython create_list.py --name NAME [--description DESC] [--json]

Trigger: "create list", "new list"

---

Analytics Operations

get_stats.py - Get overall analytics

Copypython get_stats.py [--json]

Trigger: "heyreach stats", "overall stats", "analytics"

---

get_metrics.py - Get campaign metrics

Copypython get_metrics.py --campaign-id ID [--json]

Trigger: "campaign metrics", "campaign performance"

---

Smart Routing Table

---

Example Interactions

User: "show my heyreach campaigns"

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

Display:

CopyFound 3 campaigns:

1. Q4 Enterprise Outreach
   Status: ACTIVE
   Leads: 350 | Contacted: 180 | Replied: 22
   ID: camp-abc123

2. Startup Founders
   Status: PAUSED
   Leads: 200 | Contacted: 95 | Replied: 12
   ID: camp-def456

---

User: "add linkedin.com/in/john-doe and linkedin.com/in/jane-smith to Q4 Enterprise"

Copypython 00-system/skills/heyreach/heyreach-master/scripts/add_leads.py \
  --campaign-id camp-abc123 \
  --linkedin-urls "linkedin.com/in/john-doe,linkedin.com/in/jane-smith" \
  --json

Display:

Copy✅ Leads added to campaign!
   Campaign ID: camp-abc123
   Added: 2

---

User: "what are my overall stats?"

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

Display:

Copy📊 HeyReach Analytics Overview

Total Campaigns: 5
Active Campaigns: 3

Overall Performance:
  Total Leads: 1,200
  Contacted: 650
  Replied: 78

Rates:
  Connection Rate: 45.5%
  Reply Rate: 12.0%

---

Error Handling

---

References

• setup-guide.md - Complete setup
• api-reference.md - API docs
• error-handling.md - Troubleshooting

---

Version: 1.0 Created: 2025-12-19