Build targeted prospect lists: find & enrich leads with Surfe to HubSpot

Build Hyper-Targeted Prospecting Lists with Surfe & HubSpot This template automatically discovers companies that match your Ideal Customer Profile (ICP), finds the right people inside those companies and enriches them — ready to drop straight into HubSpot. Launch the workflow, sit back, and get a clean list of validated prospects in minutes. --- 1. ❓ What Problem Does This Solve? Sourcing prospects that truly fit your ICP is slow and repetitive. You jump between databases, copy domains, hunt down decision-makers, and then still have to enrich emails and phone numbers one by one. This workflow replaces all that manual effort: 1. It queries Surfe’s database for companies that match your exact industry, size, revenue and geography filters. 2. It pulls the best-fit people inside each company and enriches them in bulk. 3. It keeps only records with both a direct email and mobile phone, then syncs them to HubSpot automatically. No spreadsheets, no copy-paste — just a fresh, qualified prospect list ready for outreach. --- 2. 🧰 Prerequisites You’ll need: - A self-hosted or cloud instance of n8n - A Surfe API Key - A HubSpot Private App Token with contact read/write scopes - A Gmail account (OAuth2) for the completion notification - The workflow JSON file linked above N8NFLOW2BuildingProspectingLists.json --- 3. 📌 Search ICP Companies Configuration — Fine-Tune Your Targeting 3.1 Editing the JSON Every targeting rule lives inside the “🔍 Search ICP Companies” HTTP node. Open the node Search ICP Companies → Parameters tab → JSON Body to edit the filters. | Filter | JSON path | What it does | Example | | --- | --- | --- | --- | | industries | filters.industries | Narrow to specific verticals (case-sensitive strings) | ["Software","Apps","SaaS"] | | employeeCount.from / to | filters.employeeCount | from / to | 1 / 35 | | countries | filters.countries | 2-letter ISO codes | ["FR","DE"] | | revenues | filters.revenues | Annual revenue brackets | ["1-10M"] | | limit | limit | Companies per run | 20 | 3.2 Where to find allowed values Surfe exposes an “🗂 Get Filters” endpoint that returns every accepted value for: - industries - employeeCounts - revenues - countries (always ISO-2 codes) You can hit it with a simple GET /v1/people/search/filters request or browse the interactive docs here: developers.surfe.com For company-level searches, the same enumerations apply. --- 4. ⚙️ Setup Instructions 4.1 🔐 Create Your Credentials in n8n --- 4.1.1 🚀 Surfe API 1. In your Surfe dashboard → Use Surfe Api → copy your API key 2. Go to n8n → Credentials → Create Credential 1. Choose Credential Type: Bearer Auth 2. Name it something like SURFE API Key 3. Paste your API key into the Bearer Token 4. Save --- 4.1.2 📧 Gmail OAuth2 API 1. Go to n8n → Credentials 2. Create new credentials: - Type: Gmail OAuth2 API 3. A pop-up window will appear where you can log in with your Google account that is linked to Gmail - Make sure you grant email send permissions when prompted --- 4.1.3 🎯 HubSpot 🔓 Private App Token 1. Go to HubSpot → Settings → Integrations → Private Apps 1. Create an app with scopes: - crm.objects.contacts.read - crm.objects.contacts.write - crm.schemas.contacts.read 2. Save the App token 2. Go to n8n → Credentials → Create Credential → HubSpot App Token 1. Paste your App Token ✅ You are now all set for the credentials --- 4.2 📥 Import and Configure the N8N Workflow - Import the provided JSON workflow into N8N - Create a New Blank Workflow - click the … on the top left - Import from File 4.2.1 🔗 Link Nodes to Your Credentials In the workflow, link your newly created credentials to each node of this list : - Surfe HTTP nodes: - Authentication → Generic Credential Type - Generic Auth Type → Bearer Auth - Bearer Auth → Select the credentials you created before - Gmail Node Credentials to connect with → Gmail account - Hubspot Node →Credentials to connect with → Gmail account Surfe HTTP nodes Surfe HTTP nodes - HubSpot node → Credentials to connect with → select your HubSpot credentials in the list --- 5. 🔄 How This N8N Workflow Works 1. Manual Trigger – Click Execute Workflow (or schedule it) to start. 2. Search ICP Companies – Surfe returns company domains that match your filter set. 3. Prepare JSON Payload with Company Domains – Formats the domain list for the next call. 4. Search People in Companies – Finds people inside each company. 5. Prepare JSON Payload Enrichment Request – Builds the bulk-enrichment request. 6. Surfe Bulk Enrichments API – Launches one enrichment job for the whole batch. 7. Wait + Polling loop – Checks job status every 3 seconds until it’s COMPLETED. 8. Extract List of People – Pulls the enriched contacts from Surfe’s response. 9. Filter: phone AND email – Keeps only fully reachable prospects (email and mobile). 10. HubSpot: Create or Update – Inserts/updates each contact in HubSpot. 11. Gmail – Sends you a “Your ICP prospecting enrichment is done” email. --- 6. 🧩 Use Cases - Weekly prospect list refresh – Generate 50 perfectly-matched prospects every Monday morning. - Territory expansion – Spin up a list of SMB software CEOs in a new country in minutes. - ABM prep – Build multi-stakeholder buying-group lists for target accounts. - Campaign-specific lists – Quickly assemble contacts for a limited-time product launch. --- 7. 🛠 Customization Ideas prepare - 🎯 Refine filters for people – Add seniorities or other filters in the node JSON PAYLOAD WITH Company Domains - use the surfe search people api doc - ♻️ Deduplicate – Check HubSpot first to skip existing contacts. - 🟢 Slack alert – Replace Gmail with a Slack notification. - 📊 Reporting – Append enriched contacts to a Google Sheet for analytics. --- 8. ✅ Summary Fire off the workflow, and n8n will find ICP-fit companies, pull key people, enrich direct contact data and drop everything into HubSpot — all on autopilot. Prospecting lists, done for you.