Skip to main content
HeyReach runs your LinkedIn outreach at scale — and the Stairoids integration captures every meaningful response as a signal. When a prospect accepts your connection request, replies to a message, or views a profile in your sequence, Stairoids receives that event and can immediately act on it: updating a deal stage, enrolling them in an email sequence, or notifying your team. You can also push actions back to HeyReach to start campaigns, add contacts to sequences, or pause outreach when a deal progresses.

​
Prerequisites

Before connecting, make sure you have:
  • A HeyReach account with API access enabled
  • Your HeyReach API key (available under Settings → API in the HeyReach dashboard)
  • At least one active or paused campaign in HeyReach to select during setup
  • Admin access in your Stairoids workspace

​
Connect HeyReach

1

Copy your HeyReach API key

In HeyReach, navigate to Settings → API and copy your API key. If you haven’t generated one yet, click Generate API Key and copy the value shown.
2

Open Integration Settings in Stairoids

Navigate to Settings → Integrations and click Add Integration.
3

Select HeyReach

Choose HeyReach from the integration catalog. Paste your API key into the API Key field and click Connect.
4

Select campaigns to monitor

Stairoids loads all campaigns from your HeyReach account. Toggle on the campaigns whose engagement events you want to convert into signals. You can add or remove campaigns at any time from Settings → Integrations → HeyReach → Configure.
5

Verify the connection

Stairoids confirms the API key is valid and begins monitoring the selected campaigns. New engagement events from HeyReach will appear in your Signal Feed as they occur.
linkedin_connection_accepted and linkedin_message_replied signals are among the highest-intent signals Stairoids can receive. A reply in particular signals an active conversation is underway. Consider building automations that immediately update a deal stage in your CRM, notify the account owner, or pause further LinkedIn outreach to avoid over-messaging an engaged prospect.

​
Supported incoming signal types

Signal typeTriggerKey properties
linkedin_connection_acceptedProspect accepts a connection requestlinkedin_profile_url, campaign_id, campaign_name, accepted_at
linkedin_message_repliedProspect replies to a LinkedIn messagelinkedin_profile_url, campaign_id, message_preview, replied_at
linkedin_profile_viewedProspect views the sender’s LinkedIn profilelinkedin_profile_url, campaign_id, viewed_at

​
Contact matching

When a HeyReach signal arrives, Stairoids attempts to match it to an existing contact in the following order:
  1. LinkedIn profile URL — if a contact in your workspace has a matching LinkedIn URL stored, the signal is attached to them directly.
  2. Email address — if HeyReach has an email associated with the prospect and a contact with that email exists in your workspace, Stairoids uses that match.
  3. No match found — Stairoids creates a new contact record using the LinkedIn profile URL, name, and any other fields HeyReach provides for the prospect.
To improve match rates, make sure your Stairoids contacts have LinkedIn URLs populated. You can bulk-import LinkedIn URLs via the Contacts → Import tool.

​
Supported outgoing actions

When a Stairoids automation targets HeyReach, it can perform the following actions:
  • Start a campaign — launch a specific HeyReach campaign for a contact
  • Add to sequence — add a contact to an existing outreach sequence within a campaign
  • Pause a campaign — pause outreach for a specific contact within a campaign (useful when a prospect replies or progresses to a meeting)
Use the Pause a campaign action as part of any automation triggered by a meeting booked or deal stage advancement in HubSpot or Pipedrive. This prevents your team from continuing to send LinkedIn messages to a prospect who’s already in an active sales conversation.

​
Troubleshooting

  1. Confirm your HeyReach API key has sufficient permissions. API keys generated by sub-users may have restricted access to certain campaigns. Use an API key generated by an account owner or admin.
  2. Check that the campaigns you expect to see are not in Draft status in HeyReach. Only Active and Paused campaigns are returned by the HeyReach API.
  3. If you created a campaign recently, refresh the campaign list in Stairoids by going to Settings → Integrations → HeyReach → Configure and clicking Refresh Campaigns.
  1. Verify the campaign is toggled on under Settings → Integrations → HeyReach → Configure. Adding a new campaign to HeyReach after the initial setup requires you to manually toggle it on in Stairoids.
  2. Check the HeyReach API status. During periods of high load or scheduled maintenance, HeyReach may delay event delivery. Check status.heyreach.io for any ongoing incidents.
  3. Confirm that your HeyReach account has not hit its API rate limit. High-volume campaigns generating many simultaneous events can occasionally trigger rate limiting. Stairoids retries failed API calls automatically, but there may be a short delay during burst periods.
  4. If signals were flowing and then stopped, check whether your HeyReach API key was regenerated. If so, update it in Stairoids under Settings → Integrations → HeyReach → Reconnect.