HeyReach is a multichannel outreach platform designed to help businesses and professionals engage with their audience effectively.
HeyReach is a multichannel outreach platform designed to help businesses and professionals engage with their audience effectively. On Nagent, Heyreach is exposed as a fully-configurable marketing automation integration that any agent can call — 19 actions, and API key authentication. No code is required to wire Heyreach into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Heyreach to automate the kinds of tasks marketing automation teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Heyreach into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Heyreach, with input parameters and output schema. Drop these into any step of an agent built in Helix.
HEYREACH_ADD_LEADS_TO_LIST_V2Tool to add leads to a lead list in HeyReach for LinkedIn campaigns. Accepts up to 100 leads per request and returns counts of added, updated, and failed leads.
Input parameters
Array of lead objects to add. Maximum 100 leads per request.
The ID of the list to add leads to. Must be an existing list ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_CHECK_API_KEYTool to check if the API key is valid. Use before making other API calls to confirm authentication.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_CREATE_EMPTY_LISTTool to create an empty list. Use after deciding on the list name and type.
Input parameters
The name of the list to create.
The type of list to create. Use 'USER_LIST' for leads and 'COMPANY_LIST' for companies. Defaults to 'USER_LIST'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_CREATE_TAGSTool to create one or multiple tags for your workspace. Use when you need to organize leads with custom labels.
Input parameters
Array of tag objects to create. Each tag must have a displayName and color.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_CREATE_WEBHOOKTool to create a new webhook. Use when you need programmatic callbacks for HeyReach events after confirming a valid API key.
Input parameters
Type of event that triggers the webhook.
Destination URL where HeyReach will send POST event payloads.
List of campaign IDs to filter events. If empty, listens for the eventType across all campaigns.
Descriptive name for the webhook, used for identification. Maximum 25 characters.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_DELETE_WEBHOOKTool to delete an existing webhook. Use when you need to remove callbacks for outdated or unwanted webhooks.
Input parameters
Unique identifier of the webhook to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_GET_ALL_CAMPAIGNSTool to retrieve all campaigns. Use when you need a paginated list of campaigns for management or reporting.
Input parameters
Maximum number of campaigns to return (1-100)
Number of campaigns to skip
Keyword to filter campaigns by name
Filter campaigns by statuses, e.g., \['DRAFT','PAUSED'\]
Filter campaigns by LinkedIn account IDs
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_GET_ALL_LEADSTool to retrieve all leads in a HeyReach list. Use when you need paginated collection of leads after confirming a valid API key.
Input parameters
The maximum number of records to return, between 1 and 1000.
The ID of the lead list.
The number of records to skip for pagination.
Search term to filter leads by name or other relevant fields.
ISO 8601 end date for filtering leads by creation time.
ISO 8601 start date for filtering leads by creation time.
LinkedIn ID to filter leads.
LinkedIn profile URL to filter leads.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_GET_ALL_LINKEDIN_ACCOUNTSTool to retrieve all LinkedIn accounts. Use when you need a paginated list of LinkedIn accounts after confirming a valid API key.
Input parameters
Maximum number of accounts to return (1-100)
Number of accounts to skip
Keyword to filter accounts by name
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_GET_ALL_LISTSTool to retrieve all lists. Use when you need a paginated list of lists after confirming a valid API key.
Input parameters
Maximum number of lists to return.
Number of lists to skip for pagination.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_GET_ALL_WEBHOOKSTool to retrieve all webhooks. Use when you need a paginated collection of webhooks after confirming a valid API key.
Input parameters
Maximum number of webhooks to return
Number of webhooks to skip for pagination
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_GET_COMPANIES_FROM_LISTTool to get companies from a company list. Use when you need a paginated list of companies after specifying a list ID.
Input parameters
Maximum number of companies to return.
The ID of the company list to retrieve companies from.
Number of companies to skip for pagination.
Keyword to filter companies by name or description.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_GET_CONVERSATIONS_V2Tool to retrieve paginated LinkedIn conversations with advanced filters. Use when you need to fetch inbox conversations filtered by lead or profile details.
Input parameters
Maximum number of items to return (1-100)
Number of items to skip for pagination
Filtering criteria for the conversations
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_GET_LEADTool to retrieve detailed information for a lead by profile URL. Use after obtaining the exact LinkedIn profile URL to fetch full lead details.
Input parameters
The LinkedIn profile URL of the lead.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_GET_LISTS_FOR_LEADTool to retrieve all lists that contain a specific lead by profile URL. Use when you need to find which lists a lead belongs to.
Input parameters
Maximum number of lists to return.
Number of lists to skip for pagination.
The LinkedIn profile URL of the lead to find lists for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_GET_MY_NETWORK_FOR_SENDERTool to get the LinkedIn network for a specified sender account. Use when you need to retrieve paginated connections for a sender.
Input parameters
Number of items per page (must be positive)
ID of the LinkedIn sender account for which to retrieve the network
Zero-based index of the page to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_GET_OVERALL_STATSTool to get overall statistics for LinkedIn accounts and campaigns. Use when you need performance metrics including connection requests, messages, replies, and engagement rates for specified date ranges.
Input parameters
End date for statistics in ISO 8601 format (YYYY-MM-DD)
Start date for statistics in ISO 8601 format (YYYY-MM-DD)
Filter by specific LinkedIn account IDs (empty array returns stats for all accounts)
Filter by specific campaign IDs (empty array returns stats for all campaigns)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_GET_WEBHOOK_BY_IDTool to retrieve a webhook by its ID. Use when you need detailed configuration of a specific webhook after listing or creating it.
Input parameters
The unique identifier of the webhook to retrieve (positive integer)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HEYREACH_UPDATE_WEBHOOKTool to update an existing webhook’s configuration. Use when you need to modify a webhook's name, URL, event type, campaigns, or activation status after confirming the webhookId.
Input parameters
Activation status of the webhook. True to enable, False to disable, if omitted or null, the existing status is retained.
New event type to trigger the webhook. If omitted or null, the existing eventType is retained.
Unique identifier of the existing webhook to update.
New destination URL where HeyReach will send POST event payloads. If omitted or null, the existing URL is retained.
List of campaign IDs to scope the webhook. If omitted or null, retains existing campaigns; if empty list, listens for the eventType across all campaigns.
New name for the webhook. If omitted or null, the existing name is retained.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 37 agents privately built on Nagent that already use Heyreach.
Build on Nagent
Connect Heyreach to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Heyreach, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Heyreach is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Heyreach is connected, you configure its 19 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Heyreach steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Heyreach event fires, the agent kicks off automatically.
Every Heyreach action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Heyreach ships with 19 pre-built marketing automation actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Heyreach together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Heyreach-based workflows tailored to your business.