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

# n8n

> Run ReachHunt actions and start workflows from ReachHunt events

The ReachHunt nodes for n8n let you send DMs, manage leads and campaigns, and start workflows from ReachHunt events, all inside n8n.

## What you can do

* Run ReachHunt actions in any workflow with the **ReachHunt** node: send messages, manage leads and lead lists, and run campaigns and AI agents.
* Start a workflow when something happens in ReachHunt with the **ReachHunt Trigger**, such as a reply or a finished campaign.
* Give the n8n AI Agent ReachHunt actions as tools.

## Before you start

* n8n Cloud, or your own n8n server reachable over `https`.
* Full access to every section of the ReachHunt workspace, to create an API key.

## Set up

Setup takes about five minutes.

**1. Create an API key**

In ReachHunt, open [**Settings → API**](https://app.reachhunt.ai/settings/api) and create a key. n8n uses it to work in this workspace.

**2. Install the nodes**

In n8n, open **Settings → Community nodes → Install**, enter `@reachhunt/n8n-nodes-reachhunt` and install it.

On your own server without that screen, run this there instead:

```bash theme={"system"}
cd ~/.n8n/nodes && npm install @reachhunt/n8n-nodes-reachhunt
```

**3. Add the credential**

In n8n, open **Credentials → Add credential**, search for **ReachHunt API**, paste your API key and save. Leave **Base URL** as it is.

**4. Build a workflow**

Add a **ReachHunt** node to any workflow, or start a workflow with the **ReachHunt Trigger**.

## Start workflows from ReachHunt

Pick the events you want in the ReachHunt Trigger. While the workflow is on, ReachHunt sends each event to it. You can see it in [**Settings → Webhooks**](https://app.reachhunt.ai/settings/webhooks) as `n8n: <workflow name>`. Turning the workflow off removes it.

Each event arrives as ReachHunt sends it, with `id`, `type`, `apiVersion`, `createdAt`, `workspaceId` and `data`. See [Webhooks overview](https://docs.reachhunt.ai/webhooks/overview.md) for every event type.

ReachHunt sends events only to public `https://` addresses. n8n Cloud works as it is. A self-hosted n8n must be reachable over `https`, and needs `WEBHOOK_URL` set if it runs behind a proxy.

To send a sample event, open the webhook in [**Settings → Webhooks**](https://app.reachhunt.ai/settings/webhooks) and select **Send test event**.

## Available actions

| Resource | Actions |
| - | - |
| Account | Get Many, Get Limits |
| AI Agent | Get, Get Many, Pause, Resume, Assign Account, Unassign Account, Set Conversation Mode |
| Campaign | Create, Get, Get Many, Update, Start, Pause, Resume, Stop, Get Targets, Get Activity |
| Conversation | Get, Get Many, Find or Start, Get Profile, Mark as Read, Mark as Unread, Close, Reopen, Add Tag, Remove Tag, Set Status, Set Assignee, Set Note, Set Deal Value |
| Internal Note | Create, Get Many |
| Lead | Search, Find People, Look Up X Profile, Update Tags, Set Status, Set Note, Set Deal Value |
| Lead List | Create, Get, Get Many, Get Leads, Add Leads, Copy Leads, Start Import, Stop Import, Get Imports |
| Message | Send, Get Many, React |
| Request | Get Many, Answer |
| Scheduled Message | Create, Get Many, Cancel |
| Status | Create, Get Many |
| Tag | Create, Get Many |
| Template | Create, Get Many |
| Workspace | Get Activity Summary, Get Credits |

> [!WARNING]
>
> Actions that send messages, react, answer requests or start campaigns reach real people from your connected accounts.

## Workflow ideas

| Idea | Flow |
| - | - |
| Ping Slack when a lead replies | `ReachHunt Trigger (Campaign Lead Replied)` → `Slack (Send Message)` |
| Add leads from a Google Sheet | `Google Sheets Trigger (Row Added)` → `ReachHunt (Lead List: Add Leads)` |
| Send booked meetings to your CRM | `ReachHunt Trigger (Lead Status Changed)` → `IF (status is Meeting booked)` → `HubSpot (Create Deal)` |
| Reply with your own AI | `ReachHunt Trigger (Message Received)` → `OpenAI (Message a Model)` → `ReachHunt (Message: Send)` |

## Tips

* Accounts, lead lists, campaigns, AI agents, tags, statuses and teammates come with a searchable list. Switch to **By ID**, or use an expression instead.
* Turn on **Return All** to page through everything, or set **Limit**. It is 50 by default.
* Most conversation actions need the account and the conversation. Map them from the trigger, for example `{{ $json.data.account.id }}` and `{{ $json.data.message.conversationId }}`.
* **Send At** on a scheduled message uses the time zone of the workflow.
* Leave **Status** or **Assignee** empty to clear it.
* When an action fails, the node shows ReachHunt's own message, such as `Campaign not found`. With **On Error → Continue**, the error goes to the output instead of stopping the workflow.

## Disconnect n8n

n8n works through its API key. Delete that key in [**Settings → API**](https://app.reachhunt.ai/settings/api) to disconnect n8n.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.