Overview
The HeyReach integration lets users connect their HeyReach account so Alysio can manage LinkedIn outreach campaigns and lists, view leads and conversations, and check connection and stats on their behalf. Users can ask Alysio to list or get campaigns, pause or resume campaigns, add leads to campaigns or lists, get leads from campaigns or lists, get campaigns for a lead, stop a lead in a campaign, list companies from a list, create lists, delete leads from lists, get a lead by LinkedIn profile URL, get conversation history, list LinkedIn accounts, check if a sender is connected to a lead, get network info, and get overall stats—all in natural language. Authentication is via API key (not OAuth 2.0). Useheyreach_get_linkdin_accounts_list for linkedInAccountId and heyreach_get_all_campaigns for campaignId when adding leads to campaigns; use heyreach_get_leads_from_campaign or heyreach_get_leads_from_list and the lead’s linkedin_id as leadMemberId when stopping a lead or deleting from a list.
Supported capabilities / objects
- Campaigns — List all campaigns; get campaign by ID; resume or pause campaign; add leads to campaign; get leads from campaign; get campaigns for a lead (by email, LinkedIn ID, or profile URL); stop lead in campaign.
- Lists — List all lists; get list by ID; get leads from list; get companies from list (company lists only); add leads to list; create empty list; delete lead(s) from list (by leadMemberId or profile URL).
- Leads — Get lead by LinkedIn profile URL.
- Conversations — Get conversation history (inbox) with filters and pagination.
- LinkedIn accounts — List all LinkedIn accounts; get LinkedIn account by ID.
- Network & stats — Check if sender is connected to a lead (by profile URL or LinkedIn ID); get network info for a sender; get overall stats (optional filters by account/campaign IDs).
Authentication
Method: API key (not OAuth 2.0). HeyReach connection uses a single API key. Users must obtain the API key from their HeyReach account and enter it when connecting HeyReach to Alysio (e.g. in the HeyReach integration form). The MCP sends requests using the stored credential. Redirect URI: Not applicable—HeyReach connection does not use OAuth 2.0. Required credentials- API Key — Enter your HeyReach API key. Obtain it from your HeyReach account/settings (e.g. API or integrations section). Required for all HeyReach API calls.
- The API key is stored as part of the HeyReach connection.
- The system uses it to authenticate requests to the HeyReach API.
- Each user/tenant has their own credential; the MCP uses the appropriate credential so calls are isolated per connection.
- If the key changes (e.g. rotated or regenerated), the user must update the connection in Settings → Integrations.
- On disconnect, HeyReach tools are unavailable until the user reconnects with a valid API key.
| Credential | Purpose |
|---|---|
| API Key | Authenticates the application to the HeyReach API for campaigns, lists, leads, conversations, LinkedIn accounts, and stats. |
MCP Tools
The HeyReach MCP exposes the following tools. Users can invoke these capabilities through natural language in Alysio.| Tool | Description | Example user prompts |
|---|---|---|
heyreach_get_all_campaigns | Retrieves a paginated list of all HeyReach campaigns and their basic details. | ”List all HeyReach campaigns”, “Show my campaigns.” |
heyreach_get_campaign_by_id | Retrieves detailed information for a specific campaign by campaign ID. | ”Get campaign 123”, “Campaign details.” |
heyreach_make_campaign_resume | Resumes a paused HeyReach campaign. | ”Resume campaign X”, “Turn campaign back on.” |
heyreach_make_campaign_pause | Pauses an active HeyReach campaign. | ”Pause campaign X”, “Stop this campaign.” |
heyreach_add_leads_to_campaign | Adds leads to a HeyReach campaign; use heyreach_get_linkdin_accounts_list and heyreach_get_all_campaigns for IDs. | ”Add these leads to campaign 123”, “Enroll leads in campaign.” |
heyreach_get_leads_from_campaign | Gets leads from a specific campaign (use linkedin_id as leadMemberId elsewhere). | ”Leads in this campaign”, “Who’s in campaign X?” |
heyreach_get_campaigns_for_lead | Retrieves campaigns for a lead by email, LinkedIn ID, or profile URL; at least one identifier required. | ”Which campaigns is this lead in?”, “Campaigns for john@company.com.” |
heyreach_stop_lead_in_campaign | Stops a lead in a campaign; provide leadMemberId (linkedin_id from get_leads) or leadUrl. | ”Stop this lead in the campaign”, “Remove lead from campaign.” |
heyreach_get_all_lists | Retrieves all company and lead lists and their basic details. | ”List HeyReach lists”, “Show all lists.” |
heyreach_get_leads_from_list | Gets leads from a specific list (use linkedin_id as leadMemberId for delete/stop). | ”Leads in list X”, “Who’s in this list?” |
heyreach_get_companies_from_list | Retrieves companies from a list; list must be a company list (listType: COMPANY_LIST). | ”Companies in this list”, “Get companies from list.” |
heyreach_add_leads_to_list | Adds leads to a HeyReach list. | ”Add leads to list X”, “Put these leads in the list.” |
heyreach_get_list_by_id | Retrieves detailed information for a list by list ID. | ”Get list 456”, “List details.” |
heyreach_delete_lead_from_list | Deletes one or more leads from a list; use linkedin_id from get_leads as leadMemberId. | ”Remove this lead from the list”, “Delete leads from list.” |
heyreach_delete_lead_from_list_by_profile_url | Deletes a lead from a list by LinkedIn profile URL. | ”Remove lead by profile URL from list.” |
heyreach_get_lead | Retrieves a lead’s details by LinkedIn profile URL. | ”Get lead for this LinkedIn URL”, “Lead details.” |
heyreach_create_empty_list | Creates an empty list in HeyReach. | ”Create a new list”, “Create empty list.” |
heyreach_get_conversation_history | Retrieves conversation history (inbox) with optional filters and pagination. | ”Show HeyReach conversations”, “Inbox messages.” |
heyreach_get_linkdin_accounts_list | Retrieves all LinkedIn accounts (use for linkedInAccountId when adding leads to campaign). | ”List LinkedIn accounts”, “HeyReach LinkedIn accounts.” |
heyreach_get_linked_in_account_by_id | Retrieves a LinkedIn account by account ID. | ”Get LinkedIn account 789”, “Account details.” |
heyreach_get_is_connection_info | Checks whether a LinkedIn sender is connected to a lead; provide leadProfileUrl or leadLinkedInId. | ”Is this sender connected to this lead?”, “Connection status.” |
heyreach_get_my_network_sender | Retrieves network information for a LinkedIn sender account. | ”My network for this sender”, “Sender network info.” |
heyreach_get_overall_stats | Retrieves overall stats for LinkedIn senders and campaigns; optional filters by account/campaign IDs. | ”HeyReach overall stats”, “Stats for these campaigns.” |
App Behavior
- API calls are made on-demand only when the user asks something that requires HeyReach data or an action (e.g. list campaigns, add leads, pause/resume, list leads, conversation history, stats). There is no background sync; each request triggers the relevant HeyReach API call using the user’s stored credential.
- User asks: “Add these three leads to our Q1 outreach campaign.”
- Alysio routes the request to the HeyReach MCP.
- The MCP may call
heyreach_get_all_campaignsto resolve the Q1 campaign ID andheyreach_get_linkdin_accounts_listfor linkedInAccountId, thenheyreach_add_leads_to_campaignwith campaign ID, account ID, and lead details. - The request is sent using the user’s stored API key.
- The MCP returns the result; Alysio confirms in chat.
Troubleshooting
Common issues- HeyReach not connected — User has not entered the API key in the connection form. Fix: In Settings → Integrations, connect HeyReach and enter the API key (from HeyReach account/settings).
- 401 Unauthorized — API key invalid or revoked. Fix: Regenerate or copy the correct API key from HeyReach and update the connection in Alysio.
- Adding leads to campaign — add_leads_to_campaign needs linkedInAccountId and campaignId. Fix: Use
heyreach_get_linkdin_accounts_listfor linkedInAccountId andheyreach_get_all_campaignsfor campaignId. - leadMemberId for stop/delete — stop_lead_in_campaign and delete_lead_from_list expect leadMemberId (the lead’s linkedin_id). Fix: Get leads via
heyreach_get_leads_from_campaignorheyreach_get_leads_from_listand use thelinkedin_idvalue as leadMemberId; or use leadUrl / profile URL where supported (e.g. stop_lead_in_campaign, delete_lead_from_list_by_profile_url). - Companies from list — get_companies_from_list only works for lists with listType COMPANY_LIST. Fix: Use a company list; use get_all_lists or get_list_by_id to confirm list type.
- Email: support@alysio.ai