skills.rest
FahadImdad
FahadImdadCOMMUNITY
Explore all skills by this author β†’
GitHub

heyreach

Automate LinkedIn outreach campaigns, leads, and analytics through the HeyReach API.

Updated Jan 22, 2026
Search Tags:#api integration#linkedin#sales analytics#lead generation#campaign management#outreach automation#heyreach
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill heyreach-fahadimdad
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: heyreach
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/heyreach
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill heyreach-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

πŸ’‘ This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve? Managing LinkedIn outreach campaigns manually through the HeyReach web interface is slow and repetitive. This Skill lets you list campaigns, add leads, check stats, and manage conversations directly from your AI assistant using natural language commands. ## Core Features & Use Cases - Campaign Management: List campaigns, view details, and pause or resume outreach with simple commands. - Lead Operations: Add leads by LinkedIn URL to campaigns, retrieve campaign leads, and create or list lead lists. - Analytics & Conversations: Pull overall stats, per-campaign metrics, and message threads for performance review. - Use Case: Say "add linkedin.com/in/jane-doe to my Q4 campaign" and the Skill validates your API configuration, then adds the lead via the HeyReach API and confirms the result. ## Quick Start Ask the assistant to show your HeyReach campaigns and it will verify your API key configuration and list them with status and lead counts.

Frequently Asked Questions about heyreach

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

FAQPage Schema
How do I add leads to a HeyReach campaign?β–Ό

Run the add_leads.py script with --campaign-id and either --linkedin-urls as a comma-separated list or --leads as a JSON array. The script posts the leads to the HeyReach API and reports how many were added.

How do I list my HeyReach campaigns from the command line?β–Ό

Run list_campaigns.py with optional --limit and --offset flags for pagination. It returns campaign names, statuses, lead counts, and IDs, with a --json flag for structured output.

What API key does HeyReach integration require?β–Ό

You need a HEYREACH_API_KEY from HeyReach Settings β†’ API, saved in a .env file at the project root. The check_heyreach_config.py script validates the key against the HeyReach API before operations run.

Why does my HeyReach API request return a 401 error?β–Ό

A 401 error means the API key is invalid or expired. Re-run the config checker to confirm, then generate a new key in HeyReach Settings β†’ API and update the HEYREACH_API_KEY value in your .env file.

Does the HeyReach client handle rate limits automatically?β–Ό

Yes. The shared heyreach_client.py retries with exponential backoff when it receives a 429 response, respecting the 300 requests per minute limit. It also retries on server errors and timeouts up to three attempts.

Related Skills

Explore More Marketing & Sales Skills→
M4ST3R-C0NTR0LM4ST3R-C0NTR0L

lead-machine

Acquire, enrich, verify, and score B2B leads for outbound outreach.

Community
Advanced
liangdabiaoliangdabiao
60

lark-workflow-crm

Manage CRM and sales pipeline with Feishu Bitable and lark-cli workflows.

Community
Advanced
orthogonal-shorthogonal-sh
12

gtm-enrichment-deep

Enrich leads from email addresses by aggregating person and company data from Sixtyfour and Apollo.

Official
Advanced
beam-ai-teambeam-ai-team

heyreach-connect

A platform for automating workflows, campaigns, and notifications in your favorite chat tool.

Official
Advanced