HeyReach

Connect Alysio to HeyReach using an API Key

Overview

The HeyReach integration allows Alysio to securely connect with a user’s HeyReach account to manage LinkedIn outreach campaigns, lead lists, conversations, and campaign performance data.

Once connected, Alysio can retrieve campaigns, manage outreach activity, add leads to campaigns or lists, view LinkedIn conversations, and analyze campaign performance metrics using natural language queries.

The integration enables revenue and growth teams to manage LinkedIn automation workflows directly from Alysio without navigating the HeyReach interface.

Authentication is handled using a HeyReach API key, which allows Alysio to securely communicate with the HeyReach API on behalf of the user.

---

Supported Data and Capabilities

The HeyReach integration provides access to several key outreach objects and operational workflows.

Campaigns

Retrieve and manage LinkedIn outreach campaigns.

Supported campaign operations include:

Listing all campaigns
Retrieving campaign details
Pausing active campaigns
Resuming paused campaigns
Adding leads to campaigns
Retrieving leads from campaigns
Retrieving campaigns associated with a specific lead
Stopping a lead within an active campaign

---

Lists

Manage lead and company lists used in outreach campaigns.

Supported operations include:

Listing all lists
Retrieving list details
Retrieving leads from lists
Retrieving companies from company lists
Adding leads to lists
Creating new lists
Deleting leads from lists

Lists may contain individual leads or companies depending on the list type.

---

Leads

Retrieve lead information using LinkedIn profile identifiers.

Lead retrieval allows Alysio to identify campaign membership, manage list placement, and track outreach interactions.

---

Conversations

Retrieve LinkedIn conversation history associated with outreach campaigns.

This allows teams to view outreach responses and monitor engagement directly within Alysio.

---

LinkedIn Accounts

Retrieve LinkedIn sender accounts connected to the HeyReach workspace.

LinkedIn account IDs are required when enrolling leads into campaigns.

---

Network and Campaign Statistics

Retrieve campaign performance metrics and LinkedIn sender network information.

This includes metrics related to campaign activity, outreach performance, and LinkedIn connection status.

---

Authentication

The HeyReach integration uses API key authentication.

Users must obtain an API key from their HeyReach account and enter the key when connecting the integration through the Alysio Settings → Integrations panel.

Unlike OAuth-based integrations, the HeyReach connection relies on a static API key that authenticates all requests sent to the HeyReach API.

---

Credential Handling

The API key is securely stored within the Alysio platform and used to authenticate requests to the HeyReach API.

Each user or tenant maintains their own HeyReach credential, ensuring integration access remains isolated to the connected workspace.

If the API key is regenerated or rotated within HeyReach, the integration connection must be updated within Alysio.

If the integration is disconnected, HeyReach functionality will no longer be available until the user reconnects using a valid API key.

---

Required Credentials

Credential	Purpose
HeyReach API Key	Authenticates requests to the HeyReach API for campaigns, lists, leads, conversations, LinkedIn accounts, and performance statistics

API keys should be treated as sensitive credentials and stored securely.

If an API key becomes compromised, it should be regenerated in HeyReach and updated within Alysio.

---

MCP Tools

The HeyReach MCP exposes several tools that allow Alysio to manage outreach campaigns and LinkedIn data.

---

heyreach_get_all_campaigns

Retrieves a paginated list of all campaigns.

Example prompts

List all HeyReach campaigns
Show my outreach campaigns

---

heyreach_get_campaign_by_id

Retrieves detailed information for a specific campaign.

Example prompts

Show details for campaign 123
Get this campaign information

---

heyreach_make_campaign_resume

Resumes a paused outreach campaign.

Example prompts

Resume campaign X
Turn the campaign back on

---

heyreach_make_campaign_pause

Pauses an active campaign.

Example prompts

Pause campaign X
Stop this campaign

---

heyreach_add_leads_to_campaign

Adds leads to a campaign.

Example prompts

Add these leads to campaign 123
Enroll these prospects in the outreach campaign

---

heyreach_get_leads_from_campaign

Retrieves leads enrolled in a specific campaign.

Example prompts

Show leads in campaign X
List prospects in this campaign

---

heyreach_get_campaigns_for_lead

Retrieves campaigns associated with a specific lead.

Example prompts

Which campaigns is this lead in
Show campaigns for this prospect

---

heyreach_stop_lead_in_campaign

Stops a lead’s participation in a campaign.

Example prompts

Remove this lead from the campaign
Stop this prospect in outreach

---

heyreach_get_all_lists

Retrieves all lists within the HeyReach workspace.

Example prompts

Show all lists
List HeyReach lead lists

---

heyreach_get_leads_from_list

Retrieves leads contained within a list.

Example prompts

Show leads in this list
Who is in list X

---

heyreach_get_companies_from_list

Retrieves companies from a company-based list.

Example prompts

Show companies in this list
List company accounts

This tool only works for lists with the type COMPANY_LIST.

---

heyreach_add_leads_to_list

Adds leads to an existing list.

Example prompts

Add these leads to the list
Add prospects to list X

---

heyreach_get_list_by_id

Retrieves detailed information for a list.

Example prompts

Show details for list 456
Get this list information

---

heyreach_delete_lead_from_list

Deletes leads from a list using the lead member ID.

Example prompts

Remove this lead from the list
Delete prospects from this list

---

heyreach_delete_lead_from_list_by_profile_url

Deletes a lead from a list using their LinkedIn profile URL.

Example prompts

Remove this LinkedIn profile from the list

---

heyreach_get_lead

Retrieves a lead using a LinkedIn profile URL.

Example prompts

Get this LinkedIn lead
Show lead details for this profile

---

heyreach_create_empty_list

Creates a new empty list.

Example prompts

Create a new list
Make a new outreach list

---

heyreach_get_conversation_history

Retrieves LinkedIn conversation history with filtering and pagination.

Example prompts

Show LinkedIn conversations
Display outreach replies

---

heyreach_get_linkdin_accounts_list

Retrieves LinkedIn accounts connected to the workspace.

Example prompts

Show LinkedIn sender accounts
List connected LinkedIn profiles

These account IDs are required when enrolling leads into campaigns.

---

heyreach_get_linked_in_account_by_id

Retrieves details for a specific LinkedIn account.

Example prompts

Show this LinkedIn account
Get sender account details

---

heyreach_get_is_connection_info

Checks whether a LinkedIn sender is connected to a lead.

Example prompts

Is this sender connected to the lead
Check LinkedIn connection status

---

heyreach_get_my_network_sender

Retrieves network information for a LinkedIn sender account.

Example prompts

Show my LinkedIn network
Get sender network information

---

heyreach_get_overall_stats

Retrieves performance statistics for campaigns and LinkedIn senders.

Example prompts

Show HeyReach campaign stats
Get outreach performance metrics

---

App Behavior

Alysio retrieves HeyReach data on demand when users request campaign information or perform outreach actions.

There is no background synchronization between Alysio and HeyReach. Instead, API requests are executed in real time when users retrieve campaigns, manage leads, or analyze outreach performance.

All requests are authenticated using the stored HeyReach API key.

---

Example Workflow

User asks

Add these leads to our Q1 LinkedIn outreach campaign

Alysio routes the request to the HeyReach MCP.

The MCP retrieves the campaign ID using heyreach_get_all_campaigns and retrieves LinkedIn sender accounts using heyreach_get_linkdin_accounts_list.

The system sends a request using heyreach_add_leads_to_campaign with the appropriate campaign and account identifiers.

HeyReach processes the request and returns the result.

Alysio confirms the lead enrollment within the conversation interface.

---

Troubleshooting

HeyReach Not Connected

The API key has not been entered.

Solution
Navigate to Settings → Integrations and enter your HeyReach API key.

---

Authentication Error

The API key may be invalid or revoked.

Solution
Regenerate the API key within HeyReach and update the integration connection.

---

Lead Enrollment Issues

Adding leads to campaigns requires both campaignId and linkedInAccountId.

Solution
Retrieve campaign IDs using heyreach_get_all_campaigns and LinkedIn account IDs using heyreach_get_linkdin_accounts_list.

---

Lead Removal Issues

Lead removal tools require the leadMemberId, which corresponds to the lead’s linkedin_id.

Solution
Retrieve the lead’s linkedin_id using heyreach_get_leads_from_campaign or heyreach_get_leads_from_list.

---

Company List Errors

Company retrieval only works for lists with the type COMPANY_LIST.

Solution
Verify the list type using heyreach_get_list_by_id.

---

Support

For assistance configuring or troubleshooting the HeyReach integration, contact

[e-mail]

Your Alysio onboarding or account team can also assist with integration setup and outreach workflow configuration.

---