Skip to content
English
  • There are no suggestions because the search field is empty.

1.05 How to connect your HeyReach account

Learn how to link your HeyReach account to Lymera to automate your LinkedIn prospecting and receive connections and replies in your campaigns.

📘 What it is

HeyReach is a LinkedIn outreach tool. Once connected, Lymera sends it leads and receives notices of accepted connections and received messages through webhooks.

Only one LinkedIn tool can be active per company in this category. Lymera validates the token before saving it and stores it encrypted.

⚠️ Important: on some plans, the HeyReach connection is part of an add-on managed by your CSM. If the card says so, ask your CSM to make the changes.

📍 Where to find it

Side menu › SETUP › Integrations › LinkedIn category › HeyReach card.

Screen: 1.05 How to connect your HeyReach account
Screen: 1.05 How to connect your HeyReach account

🛠️ How to do it

Before you start

  • Have an active HeyReach account.
  • Have a session in Lymera with permission to connect integrations (Account Admin).

Step 1: Get the API Token in HeyReach

  1. Sign in to HeyReach and go to Settings.
  2. Open the API section.
  3. Generate a new token and copy it. It is a 44-character string that ends in “=”.
⚠️ Important: HeyReach may show you the full token only once. Copy it before closing the tab.

Step 2: Connect HeyReach in Lymera

  1. Go to SETUP › Integrations.
  2. On the HeyReach card, click Connect HeyReach.
  3. Paste the token in the HeyReach API Token field and confirm.
  4. Wait for the message “HeyReach connected.”

Step 3: Create the 2 webhooks in HeyReach

  1. On the Lymera card, copy the Webhook URL.
  2. Click 🔑 Show Secret and copy the Webhook Secret.
  3. In HeyReach go to Settings › Integrations › Webhooks › Add webhook.
  4. Create two webhooks, both with All Campaigns: one for Accepted connections and one for Received messages.
  5. In each one, add the Secret under Advanced › Custom headers.
  6. Go back to Lymera and click I have set up the webhooks ✓.
✅ Result: the card shows as connected with your account status and the LinkedIn campaigns and accounts available.

Available campaigns and profiles

The LinkedIn campaigns and profiles you can use are enabled by the Lymera team. If you don't see the ones you expect, ask your Customer Success contact.

Change or disconnect

  • To change the token, use Change API Token. A new Webhook Secret is generated: update it in the 2 HeyReach webhooks.
  • To disconnect, use Disconnect. Active campaigns with the LinkedIn channel are paused automatically and Lymera tells you how many.
💡 Tip: if your HeyReach account already has these 2 webhooks registered by another company in Lymera, don't create new ones. HeyReach allows only one per event type per account.

❓ Frequently asked questions

❓ Does connecting HeyReach use Lymera credits?

No. Connecting and maintaining the integration does not use your plan's credits.

❓ Can I have HeyReach and Lymera LinkedIn at the same time?

Both can exist in the same account, but each campaign uses only one provider. It is chosen in the campaign's LinkedIn provider setting.

❓ I get an error when pasting the token. What should I do?

It is almost always a space at the beginning or end, or a token that was deleted in HeyReach. You will see “Invalid API Token.” Generate a new one in HeyReach and paste it again.

❓ Who can connect HeyReach?

The Account Admin or your CSM, if it is a managed add-on.

🔧 If something doesn't work

What you seeLikely causeWhat to do
“Invalid API Token.”Token copied incorrectly or deletedGenerate a new one in HeyReach and paste it without spaces
“The credential could not be decrypted. Reconnect HeyReach.”The credential is corruptedReconnect with the token
Accepted connections and messages don't arriveWebhooks are missing or the Secret doesn't matchCheck that the 2 webhooks exist and have the Secret in the header
“The webhook secret has not been generated yet.”The connection was left incompleteAsk an administrator to reconnect HeyReach
“Only the Lymera team can enable HeyReach campaigns and profiles.”This is an action reserved for LymeraAsk your Customer Success contact
Campaigns paused after disconnectingThis is the expected behaviorReconnect and resume the campaigns

If the problem continues, write to support with your company name, the time and the exact message. Never share the full token.

🚀 Next steps