Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚡ Lead Qualification & CRM Sync Middleware Engine

An enterprise-grade, bi-directional RevOps integration middleware built with Node.js, Express, and HubSpot CRM API. Designed to automatically qualify incoming sales leads using a deterministic scoring rules engine and push priority scores back to HubSpot in real time.


🎯 Key Features

  • Bi-Directional HubSpot Sync: Dynamically queries HubSpot CRM via REST API to fetch lead properties and updates contact scoring upon qualification.
  • Deterministic Rules Engine: Scores leads based on company domain validation, executive title hierarchy, employee headcount, target market geography, and lifecycle stage.
  • Audit Trail Generation: Appends granular, point-by-point scoring breakdowns for full RevOps transparency and manual review routing.
  • Automated Unit Testing: Fully covered by Jest test suites verifying edge cases, student/intern filters, and existing customer pipeline bypasses.

🛠 Tech Stack

  • Backend Environment: Node.js, Express.js
  • CRM Integration: HubSpot CRM API v3 (REST, Axios)
  • Testing Suite: Jest, Supertest
  • Dev Tools & Versioning: Git, Postman, Dotenv

📊 Qualification Scoring Logic Matrix

Criteria Condition Score Impact
Email Domain Corporate Domain Verified +20 Points
Email Domain Free Email Provider (Gmail, Yahoo) +0 Points
Job Role Executive / Decision Maker (C-Level, VP, Director) +30 Points
Job Role Non-Buyer Role (Student, Intern) -20 Points
Geography Primary Target Market (US, UK, CA) +10 Points
Lifecycle Existing Customer -100 Points (Pipeline Bypass)

🚀 Getting Started

1. Prerequisites

  • Node.js v18+
  • HubSpot Private App Access Token (CRM Read & Write Scopes)

2. Environment Setup

Create a .env file in the root directory:

PORT=5000
HUBSPOT_ACCESS_TOKEN=pat-na1-xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

About

Production-ready RevOps middleware built with Node.js & Express. Connects to HubSpot CRM to dynamically fetch, score, and qualify sales leads using a deterministic rules engine, with real-time bi-directional CRM write-back and automated Jest test coverage.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages