HeyReach
Authentication Type: API Key
Description: Integrate with HeyReach for campaign and lead management with LinkedIn outreach automation.
Authentication
Authentication verification and account management.
Check API Key
Verify the validity of a HeyReach API key and retrieve account details.
Operation Type: Query (Read)
Parameters:
- None
Returns:
- Empty string response indicating successful authentication
Example Usage:
{}
Campaigns
Campaign management and statistics for HeyReach outreach campaigns.
Add Leads to Campaign
Add one or more leads to a specific HeyReach campaign.
Operation Type: Mutation (Write)
Parameters:
- campaignId
number(required): The campaign ID to add leads to - accountLeadPairs
array of objects(required): Array of LinkedIn account and lead pairs- linkedInAccountId
number(nullable): LinkedIn account ID of the sender - lead
object(required): Lead details- firstName
string(required): Lead first name - lastName
string(required): Lead last name - location
string(nullable): Lead location - summary
string(nullable): Lead summary - companyName
string(nullable): Lead company name - position
string(nullable): Lead position or job title - about
string(nullable): Lead about/bio section - emailAddress
string(nullable): Lead email address - customUserFields
array of objects(nullable): List of custom field key-value pairs- name
string: Custom field name - value
string: Custom field value
- name
- profileUrl
string(required): LinkedIn profile URL for the lead
- firstName
- linkedInAccountId
Returns:
- addedLeadsCount
number: Number of leads successfully added - updatedLeadsCount
number: Number of leads updated (profileUrl match) - failedLeadsCount
number: Number of leads that failed to add or update
Example Usage:
{
"campaignId": 123456,
"accountLeadPairs": [
{
"linkedInAccountId": 789,
"lead": {
"firstName": "John",
"lastName": "Doe",
"location": "San Francisco, CA",
"summary": "Software Engineer at Tech Co",
"companyName": "Tech Co",
"position": "Senior Software Engineer",
"about": "Passionate about building scalable systems",
"emailAddress": "john.doe@techco.com",
"customUserFields": [
{ "name": "source", "value": "linkedin" },
{ "name": "priority", "value": "high" }
],
"profileUrl": "https://www.linkedin.com/in/johndoe"
}
}
]
}
Get Overall Statistics
Fetch overall statistics for HeyReach accounts and campaigns within a date range. Account IDs are optional - if not provided, stats for all accounts will be returned.
Operation Type: Query (Read)
Parameters:
- accountIds
array of numbers(nullable): Array of HeyReach account IDs (optional; null or empty array = all accounts) - campaignIds
array of numbers(nullable): Array of campaign IDs (optional; null or empty array = all campaigns) - startDate
string(required): Start date in ISO datetime format (UTC, inclusive) - endDate
string(required): End date in ISO datetime format (UTC, inclusive)
Returns:
- byDayStats
object(nullable): Statistics grouped by date (ISO date string keys)- profileViews
number(nullable): Profile views count - postLikes
number(nullable): Post likes count - follows
number(nullable): Follows count - messagesSent
number(nullable): Messages sent count - totalMessageStarted
number(nullable): Total messages started - totalMessageReplies
number(nullable): Total message replies - connectionsSent
number(nullable): Connection requests sent - connectionsAccepted
number(nullable): Connections accepted - messageReplyRate
number(nullable): Message reply rate percentage - connectionAcceptanceRate
number(nullable): Connection acceptance rate percentage
- profileViews
- overallStats
object(nullable): Aggregated statistics for the entire date range (same structure as byDayStats)
Example Usage:
{
"accountIds": [1234, 5678],
"campaignIds": [101, 102],
"startDate": "2024-12-01T00:00:00.000Z",
"endDate": "2024-12-07T23:59:59.999Z"
}
Common Use Cases
Lead Management:
- Import leads from external sources into HeyReach campaigns
- Bulk upload prospects with LinkedIn profile information
- Track lead addition success and failure rates
Campaign Analytics:
- Monitor campaign performance across date ranges
- Compare statistics between different accounts and campaigns
- Track engagement metrics like connection acceptance and message reply rates
Account Verification:
- Validate API key credentials before performing operations
- Confirm account access and permissions