Skip to main content

​
Connect via API Key

1

Open API settings in HeyReach

In HeyReach go to Settings → API and create an API key. API keys never expire, but can be revoked from the same page.
2

Connect in OpenNous

Go to Settings → Integrations → + Add Integration → HeyReach, paste the key, and click Connect. OpenNous verifies it by calling GET /api/public/auth/CheckApiKey against https://api.heyreach.io.

​
Webhooks (auto-registered)

HeyReach exposes a webhook API, so OpenNous registers the webhooks for you on connect. No paste step needed. On connect OpenNous calls POST /api/public/webhooks/CreateWebhook once for each of these event types, all pointed at the same workspace-scoped URL:
  • MESSAGE_REPLY_RECEIVED
  • INMAIL_REPLY_RECEIVED
  • CONNECTION_REQUEST_ACCEPTED
  • LEAD_TAG_UPDATED
The resulting webhook IDs are stored on the connection so that disconnecting HeyReach in OpenNous also deletes the webhooks on the HeyReach side. See the HeyReach webhook reference for the event-to-activity mapping.

​
Optional: shared secret

For an extra layer of protection on the inbound URL, set HEYREACH_WEBHOOK_SECRET in nous.env. When set, OpenNous appends ?secret=<value> to the registered webhook URL and rejects any inbound request whose query string doesn’t match.