HeyReach
HeyReach is LinkedIn-focused outbound: campaigns, lead lists, sender account rotation, tagging, and analytics. The HTTP API is organization-scoped — one credential per HeyReach organization.
Data Model
- Campaigns — LinkedIn outreach sequences with status (DRAFT, IN_PROGRESS, PAUSED, FINISHED, etc.), progress stats, and linked sender accounts. List, get by id, pause/resume, add leads, stop leads, find campaigns for a lead.
- Lists — Lead lists (USER_LIST) or company lists (COMPANY_LIST). Create, get by id, add leads in bulk (100/request), delete leads by id or profile URL, find lists for a lead.
- Leads — LinkedIn profiles stored in lists. Look up by profile URL for full profile data (name, company, position, location, image, enriched email). Must be imported into HeyReach via a list first.
- Tags — Free-text labels on leads. Add (append), replace (destructive overwrite), or read tags. Identify leads by profile URL or LinkedIn numeric ID.
- LinkedIn Accounts — Sender accounts connected to the org. List all or get by id. Shows active status, auth validity, campaign count, Sales Navigator / Recruiter flags.
- Stats — Aggregate outreach metrics by sender accounts, campaigns, and date range. Daily and overall: profile views, messages, InMail, connections, reply rates, acceptance rates.
Gotchas
- Rate limit: 300 requests per minute org-wide; HTTP 429 when exceeded.
- POST for listing: Campaign and list listing endpoints use POST with a JSON body (offset, limit, filters), not GET with query params.
- List type matters: GetLeadsFromList only works on USER_LIST; GetCompaniesFromList only on COMPANY_LIST. Wrong type returns HTTP 400.
- AddLeadsToListV2: Max 100 leads per request. Each lead needs at least linkedInUrl.
- AddLeadsToCampaign: Campaign must NOT be in DRAFT status. Pause or start the campaign first.
- Pause/Resume: Only works on campaigns in the correct status (IN_PROGRESS for pause, PAUSED for resume).
- StopLeadInCampaign: The lead must be present in the campaign. Check with get_leads_from_campaign first.
- Tags: lead/AddTags appends; lead/ReplaceTags overwrites all tags. Both need leadProfileUrl or leadLinkedInId. lead/GetTags uses profileUrl or linkedInId.
- Delete leads: list/DeleteLeadsFromList uses leadMemberIds (integer ids from list membership). list/DeleteLeadsFromListByProfileUrl uses profileUrls (LinkedIn URLs).
