heyreach-connect_skill

Overview

This skill connects to HeyReach to automate LinkedIn outreach and campaign management. It validates configuration, prompts for API credentials if missing, and routes requests to the appropriate HeyReach operations. The skill acts as a meta-layer so you can list campaigns, add leads, fetch metrics, and manage campaign status through simple commands.

How this skill works

On first use it runs a pre-flight configuration check to confirm API access and valid credentials. If the API key is missing or invalid, it prompts you to provide and save the key. For valid configurations it routes user intents (list campaigns, add leads, get stats, toggle campaign state, list accounts/lists) to the corresponding HeyReach API operations and returns structured results or error notices.

When to use it

• When you need to list or inspect active LinkedIn outreach campaigns
• To add or bulk-import LinkedIn leads into a campaign
• When you need campaign-level metrics or overall outreach analytics
• To pause or resume a campaign quickly
• To view or manage connected LinkedIn accounts and lead lists

Best practices

• Always run the initial config validation before performing operations to catch credential or permission issues early
• Provide explicit campaign IDs when adding leads or fetching metrics to avoid ambiguity
• Supply LinkedIn profile URLs in comma-separated form when importing leads for predictable parsing
• Handle rate-limit (429) responses by implementing retries with backoff
• Keep API keys secure and rotate keys through HeyReach settings if compromised

Example use cases

• List all HeyReach campaigns to review active outreach workflows and messaging sequences
• Add multiple LinkedIn profile URLs to a target campaign for a new lead batch
• Fetch campaign metrics to evaluate send rates, replies, and conversion performance
• Pause a campaign that is underperforming or being reformatted, then resume after updates
• List connected LinkedIn accounts to confirm the sending identity and permissions