HeyReach Integration Guide
This guide covers all HeyReach actions available in TexAu. Use these actions to manage your LinkedIn outreach campaigns through HeyReach.
All HeyReach actions in TexAu cost 0 credits. You only pay for the credits on your HeyReach side.
Before you begin
- A HeyReach account is required. Sign up at heyreach.io.
- Your HeyReach API key is at Settings > Integrations inside HeyReach.
- In TexAu, go to Settings > Integrations, find HeyReach, enter your API key, and click Save.
Campaign actions
Get All Campaigns (HeyReach)
Returns a list of all campaigns in your HeyReach account.
Input: None
Output:
- Array of campaigns with:
- Campaign ID
- Campaign Name
- Status (active, paused, completed)
- Number of leads
- Number of LinkedIn accounts assigned
Use this action first to find the Campaign ID you need for other actions.
Add Leads to Campaign (HeyReach)
Adds one or more leads to a specific HeyReach outreach campaign.
Input:
- Campaign ID (required)
- LinkedIn Profile URL (required)
- First Name (optional)
- Last Name (optional)
- Company Name (optional)
- Custom variables (optional -- used in message templates)
Output:
- Lead addition status
- Lead ID in HeyReach
Typical use case: After building a prospecting list in TexAu, send qualified leads directly to a HeyReach LinkedIn outreach campaign.
Get Leads from Campaign (HeyReach)
Returns the leads in a specific HeyReach campaign along with their outreach status.
Input:
- Campaign ID (required)
- Limit (optional)
Output per lead:
- LinkedIn Profile URL
- First Name, Last Name
- Connection status
- Message sent status
- Reply status
Account actions
List LinkedIn Accounts (HeyReach)
Returns all LinkedIn accounts connected to HeyReach.
Input: None
Output:
- Array of LinkedIn accounts with:
- Account ID
- LinkedIn profile name
- Connection status
- Daily limit settings
Typical use case: Use before adding leads to confirm your LinkedIn accounts are active.
Common workflow pattern
Identify leads on LinkedIn and add to HeyReach
- Start with a list of company names or job titles in a TexAu table.
- Add an Action Column for Search LinkedIn Profiles (Apify) to find relevant profiles.
- Add a second Action Column for Get LinkedIn Profile Detail (Apify) for enrichment.
- Add a third Action Column for Add Leads to Campaign (HeyReach) mapping LinkedIn URL and first/last name.
- Run enrichment.
LinkedIn URLs flow automatically from the search results into HeyReach.
Troubleshooting
Add Leads to Campaign returns "campaign not found". Run Get All Campaigns to confirm the Campaign ID. HeyReach Campaign IDs are numeric. Do not use the campaign name.
Leads are added but are not being contacted. Verify that:
- The campaign is active (not paused or completed).
- At least one LinkedIn account is assigned to the campaign.
- The assigned LinkedIn account is connected and not restricted.
Run List LinkedIn Accounts to check account status.
Custom variables are not appearing in messages. Check that the variable names in your HeyReach message template match exactly the variable keys you send in the Add Leads action (including case).
Get Leads from Campaign returns empty. The campaign may have no leads yet, or the Campaign ID is incorrect. Use Get All Campaigns to confirm the campaign ID and lead count.