FoxReach
Back to Blog
Guides

How to Automate Cold Email with FoxReach + n8n

Install the FoxReach community node for n8n, connect your API key, and build automation workflows to manage leads and campaigns programmatically.

FoxReach Team5 min read
How to Automate Cold Email with FoxReach + n8n

Overview

The FoxReach n8n community node lets you connect FoxReach to hundreds of other apps — CRMs, spreadsheets, Slack, webhooks, and more. Create leads from form submissions, add them to campaigns automatically, and react to replies in real time.

This guide walks you through installation, setup, and three practical workflows you can build today.

Prerequisites

Before you start, make sure you have:

  • A FoxReach account with an API key (Settings > API Keys)
  • An n8n instance (self-hosted or n8n Cloud)
  • At least one connected email account and a campaign in FoxReach

Step 1: Install the Node

In your n8n instance, go to Settings > Community Nodes and install:

n8n-nodes-foxreach

This adds two nodes to your canvas:

  • FoxReach — Create, update, find, and delete leads; manage campaigns
  • FoxReach Trigger — Start workflows when events happen (replies, bounces, opens, etc.)

FoxReach node in n8n showing 11 actions and 7 triggers

If you're self-hosting n8n, you can also install via CLI: npm install n8n-nodes-foxreach in your n8n root directory and restart.

Step 2: Connect Your API Key

  1. Open any FoxReach node on the canvas
  2. Click Create New Credential under the FoxReach API credential
  3. Paste your API key (starts with otr_...)
  4. Click Save — n8n will verify the connection

Your API key is stored securely in n8n's credential vault and sent as the X-API-Key header on every request.

You can generate API keys in FoxReach under Settings > API Keys. We recommend creating a dedicated key for n8n with read+write scope.

Available Operations

Lead Operations

OperationDescription
CreateAdd a new lead with email, name, company, and other fields
GetRetrieve a lead by ID
UpdateModify any field on an existing lead
DeleteRemove a lead from your workspace
Find by EmailSearch for a lead using their email address

Campaign Operations

OperationDescription
Add LeadAdd a lead to a specific campaign
GetRetrieve campaign details by ID
Get ManyList all campaigns, optionally filtered by status
Find by NameSearch for a campaign by name
StartActivate a paused or draft campaign
PausePause an active campaign

Trigger Events

The FoxReach Trigger node starts your workflow when these events occur:

EventDescription
New Reply ReceivedA prospect replies to your outreach email
Reply CategorizedA reply is categorized (interested, not interested, etc.)
Email BouncedA sent email bounces back
Email SentAn email is successfully sent from a campaign
Email OpenedA recipient opens a tracked email
Lead CreatedA new lead is added to your workspace
Campaign CompletedAll leads in a campaign have been processed

Workflow 1: Sync New CRM Contacts to FoxReach

Automatically create leads in FoxReach whenever a new contact is added to your CRM.

Nodes:

  1. CRM Trigger (e.g., HubSpot, Pipedrive, or Google Sheets) — fires when a new contact is created
  2. FoxReach > Create Lead — creates the lead with mapped fields
  3. FoxReach > Add Lead to Campaign — adds them to your outreach campaign

Setup:

  1. Add your CRM trigger node and connect it
  2. Add a FoxReach node, set Resource to Lead and Operation to Create
  3. Map the fields from your CRM: email, first name, last name, company
  4. Add another FoxReach node, set Resource to Campaign and Operation to Add Lead
  5. Enter your campaign ID and connect the lead ID from the previous step

Workflow 2: Notify Slack on Interested Replies

Get instant Slack notifications when a prospect shows interest.

Nodes:

  1. FoxReach Trigger — set event to Reply Categorized
  2. IF Node — filter where category equals "interested"
  3. Slack > Send Message — post to your sales channel

Setup:

  1. Add the FoxReach Trigger node, select Reply Categorized
  2. Add an IF node: check if category equals interested
  3. On the true branch, add a Slack node with a message template:
New interested reply from {{$json.senderEmail}}

Subject: {{$json.subject}}
Campaign: {{$json.campaignName}}

Reply: {{$json.body}}

Workflow 3: Auto-Pause Campaign on High Bounce Rate

Protect your sender reputation by pausing campaigns that are bouncing too much.

Nodes:

  1. FoxReach Trigger — set event to Email Bounced
  2. FoxReach > Get Campaign — fetch current campaign stats
  3. IF Node — check if bounce rate exceeds threshold
  4. FoxReach > Pause Campaign — pause it automatically

Setup:

  1. Add the FoxReach Trigger with Email Bounced event
  2. Add a FoxReach node to get the campaign details using the campaign ID from the trigger
  3. Add an IF node: check if the bounce percentage is above your threshold (e.g., 5%)
  4. On the true branch, add a FoxReach node with Pause operation

Tips

  • Test with a single lead first. Before connecting a large data source, run your workflow manually with one item to verify field mapping.
  • Use the Find operations. Before creating a lead, use Find by Email to check if they already exist. This prevents duplicates.
  • Set up error handling. Add an Error Trigger workflow to catch failures — e.g., if a lead's email is already taken, the API returns a 409 conflict.
  • Rate limits. The FoxReach API allows 100 requests per minute. For bulk imports, use n8n's batch processing with a wait node between batches.

Troubleshooting

"401 Unauthorized" error Your API key is invalid or expired. Generate a new one in FoxReach Settings > API Keys.

"404 Not Found" on campaign operations The campaign ID doesn't exist or belongs to a different workspace. Double-check the ID in FoxReach.

Trigger not firing Make sure the workflow is active (toggled on). FoxReach registers a webhook when you activate the workflow and removes it when you deactivate.

Duplicate leads The API returns a 409 error if a lead with the same email already exists. Use the Find by Email operation first, or handle the error with a try/catch pattern in n8n.

What's Next

The n8n node is currently in beta. We're actively adding more operations and improving the experience. Zapier and Make.com integrations are coming soon.

Stay ahead of the inbox

Get cold email tips, deliverability hacks, and product updates. No spam, unsubscribe anytime.