> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stairoids.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect HeyReach to Stairoids for LinkedIn Signals

> Import LinkedIn connection accepts, message replies, and profile views from HeyReach campaigns as high-intent signals to power cross-channel automations.

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="Open Integration Settings in Stairoids">
    Navigate to **Settings → Integrations** and click **Add Integration**.
  </Step>

  <Step title="Select HeyReach">
    Choose **HeyReach** from the integration catalog. Paste your API key into the **API Key** field and click **Connect**.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Note>
  `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.
</Note>

## Supported incoming signal types

| Signal type                    | Trigger                                      | Key properties                                                         |
| ------------------------------ | -------------------------------------------- | ---------------------------------------------------------------------- |
| `linkedin_connection_accepted` | Prospect accepts a connection request        | `linkedin_profile_url`, `campaign_id`, `campaign_name`, `accepted_at`  |
| `linkedin_message_replied`     | Prospect replies to a LinkedIn message       | `linkedin_profile_url`, `campaign_id`, `message_preview`, `replied_at` |
| `linkedin_profile_viewed`      | Prospect views the sender's LinkedIn profile | `linkedin_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)

<Tip>
  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.
</Tip>

## Troubleshooting

<Accordion title="Campaign not visible in Stairoids during setup">
  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**.
</Accordion>

<Accordion title="Signals missing for a monitored campaign">
  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](https://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**.
</Accordion>