HubSpot Lead Creation Template

Automatically transform incoming calls into qualified leads in your HubSpot CRM. This tool enables your AI assistant to create, qualify, and enrich new contacts with relevant information in real time during the conversation.

Overview & Features

Automatic Lead Capture

Real-time contact creation from conversation
Intelligent data extraction (name, email, company)
Lead score calculation based on conversation
Automatic categorization and tagging

BANT Qualification

Budget assessment through conversation analysis
Authority level determination
Need analysis and pain point identification
Timeline detection for purchase decision

Configure Lead Creation Tool

1. Basic Tool Setup

Tool Configuration
Headers

Parameter	Value
Function Name	`create_hubspot_lead`
Description	”Creates a new lead in HubSpot based on conversation information. Use when a potential customer shows interest and is not yet in the system.”
HTTP Method	`POST`
Timeout	`7000ms`
URL	`https://api.hubapi.com/crm/v3/objects/contacts`

Authorization: "Bearer YOUR_HUBSPOT_API_KEY"
Content-Type: "application/json"
User-Agent: "Famulor-LeadGen/1.0"

2. Request Body Template

{
  "properties": {
    "firstname": "{first_name}",
    "lastname": "{last_name}",
    "email": "{email_address}",
    "phone": "{phone_number}",
    "company": "{company_name}",
    "jobtitle": "{job_title}",
    "website": "{company_website}",
    "lifecyclestage": "lead",
    "leadsource": "phone_call",
    "hs_lead_status": "NEW",
    "lead_score": "{calculated_score}",
    "notes_last_updated": "{conversation_summary}",
    "budget_range": "{estimated_budget}",
    "timeline": "{buying_timeline}",
    "pain_points": "{identified_challenges}",
    "interest_level": "{engagement_score}",
    "hs_analytics_source": "famulor_ai_call",
    "createdate": "{current_timestamp}"
  }
}

3. Parameter Schema

{
  "type": "object",
  "properties": {
    "first_name": {
      "type": "string",
      "description": "Contact's first name"
    },
    "last_name": {
      "type": "string", 
      "description": "Contact's last name"
    },
    "email_address": {
      "type": "string",
      "format": "email",
      "description": "Lead's email address"
    },
    "phone_number": {
      "type": "string",
      "description": "Contact's phone number"
    },
    "company_name": {
      "type": "string",
      "description": "Company name"
    },
    "job_title": {
      "type": "string",
      "description": "Contact's position/job title"
    },
    "company_website": {
      "type": "string",
      "description": "Company website (if mentioned)"
    },
    "calculated_score": {
      "type": "integer",
      "description": "Lead score based on conversation quality (0-100)",
      "minimum": 0,
      "maximum": 100
    },
    "conversation_summary": {
      "type": "string",
      "description": "Summary of key conversation points"
    },
    "estimated_budget": {
      "type": "string",
      "description": "Estimated or stated budget range"
    },
    "buying_timeline": {
      "type": "string",
      "description": "Time frame for purchase decision"
    },
    "identified_challenges": {
      "type": "string",
      "description": "Challenges/pain points identified during conversation"
    },
    "engagement_score": {
      "type": "string",
      "enum": ["low", "medium", "high"],
      "description": "Interest level based on conversation engagement"
    }
  },
  "required": ["first_name", "last_name", "phone_number"]
}

Intelligent Lead Qualification

BANT Framework Implementation

Budget Assessment

Automatic Budget Detection:

Direct Statements:
  "Our budget is 50,000€" → budget_range: "50k-60k"
  "We have about ten thousand euros planned" → budget_range: "10k-15k"

Indirect Hints:
  "We are a small startup" → budget_range: "under_10k"
  "Budget is not an issue" → budget_range: "flexible"
  "We need to see..." → budget_range: "limited"

Lead Score Impact:
  High Budget (&gt;50k): +25 points
  Medium Budget (10-50k): +15 points  
  Low Budget (&lt;10k): +5 points
  Unknown: 0 points

Authority Assessment

Decision Authority Classification:

Decision Maker:
  Indicators: "I am the CEO", "I can decide this"
  Lead Score: +30 points
  Tag: "decision_maker"

Influencer:
  Indicators: "I am the IT manager", "I will recommend this"
  Lead Score: +20 points
  Tag: "influencer"

Gatekeeper:
  Indicators: "I’m just gathering information first", "I need to forward this"
  Lead Score: +10 points
  Tag: "gatekeeper"

User/Stakeholder:
  Lead Score: +5 points
  Tag: "stakeholder"

Need Analysis

Pain Point Categorization:

Technical Challenges:
  Keywords: "Integration", "Performance", "Scaling"
  Category: "technical_needs"
  Urgency: high

Business Challenges:  
  Keywords: "Efficiency", "Costs", "Growth", "Competition"
  Category: "business_needs"
  Urgency: medium-high

Compliance/Security:
  Keywords: "GDPR", "Security", "Audit", "Compliance"
  Category: "compliance_needs"
  Urgency: high

Process Optimization:
  Keywords: "Automation", "Workflow", "Process"
  Category: "process_needs"
  Urgency: medium

Timeline Assessment

Buying Timeline Classification:

Immediate (0-1 month):
  Indicators: "immediately", "urgent", "as soon as possible"
  Timeline: "immediate"
  Lead Score: +25 points

Short-term (1-3 months):
  Indicators: "in the next months", "by end of quarter"
  Timeline: "1-3_months"
  Lead Score: +20 points

Medium-term (3-6 months):
  Indicators: "this year", "mid-term"
  Timeline: "3-6_months" 
  Lead Score: +15 points

Long-term (6+ months):
  Indicators: "next year", "long-term planning"
  Timeline: "6+_months"
  Lead Score: +10 points

Undefined:
  Timeline: "undefined"
  Lead Score: +5 points

Advanced Lead Enrichment

Company Enrichment Tool

Tool Configuration
Request Body

Function Name: enrich_hubspot_company
Description: "Enriches lead with company data based on company name or website"
HTTP Method: POST
URL: https://api.hubapi.com/crm/v3/objects/companies

{
  "properties": {
    "name": "{company_name}",
    "domain": "{company_website}",
    "industry": "{identified_industry}",
    "numberofemployees": "{estimated_company_size}",
    "annualrevenue": "{estimated_revenue}",
    "company_source": "ai_conversation_analysis",
    "description": "{company_description_from_conversation}"
  }
}

Lead-Company Association

{
  "associations": [
    {
      "to": {
        "id": "{company_id}"
      },
      "types": [
        {
          "associationCategory": "HUBSPOT_DEFINED",
          "associationTypeId": 1
        }
      ]
    }
  ]
}

Practical Implementation

Scenario 1: Inbound Lead from Cold Call

First Contact & Data Collection

AI Assistant: "May I ask who I am speaking with?"
Customer: "This is Max Mustermann from Beispiel GmbH"

→ Automatic Data Extraction:
  first_name: "Max"
  last_name: "Mustermann"  
  company_name: "Beispiel GmbH"

Needs Exploration

AI: "How can I assist you?"
Customer: "We're looking for a new CRM solution. Our current system 
          is too slow and integration doesn't work."

→ Pain Point Analysis:
  pain_points: "Performance issues, integration challenges"
  category: "technical_needs"
  urgency: "high"

BANT Qualification

Budget: "What budget range are you considering?"
Authority: "Who makes software decisions at your company?"
Need: "What features are most important to you?"
Timeline: "By when do you want to implement a solution?"

→ Lead score calculation based on answers

Lead Creation & Follow-up

create_hubspot_lead(
  first_name: "Max",
  last_name: "Mustermann",
  company_name: "Beispiel GmbH", 
  calculated_score: 75,
  timeline: "1-3_months",
  pain_points: "CRM performance & integration issues"
)

→ Automatic follow-up task creation  
→ Sales team notification

Scenario 2: Warm Lead with High Intent

Response Handling & Follow-up

Successful Lead Creation

{
  "id": "lead12345",
  "properties": {
    "firstname": "Max",
    "lastname": "Mustermann",
    "email": "max@beispiel.de",
    "company": "Beispiel GmbH",
    "lifecyclestage": "lead",
    "hs_lead_status": "NEW",
    "lead_score": "75",
    "createdate": "2024-01-15T10:30:00.000Z"
  },
  "createdAt": "2024-01-15T10:30:00.000Z"
}

Automatic Follow-up Workflows

Immediate Actions

Right after lead creation:

Send lead confirmation email  
Notify sales team (if score &gt;70)  
Create CRM task: "Lead follow-up within 24 hours"  
Add lead to appropriate HubSpot list  
Start marketing automation sequence  

Delayed Workflows

24-48 hours later:

If no sales contact made:
  → Automated follow-up email  
  → SMS reminder (for high score leads)  
  → Manager escalation (if score &gt;80)

After 1 week:
  → Lead nurturing email series  
  → LinkedIn connection request  
  → Schedule re-engagement call  

Lead Scoring Updates

Continuous score adjustment:

Email engagement: +5 points  
Website visits: +3 points per session  
Content downloads: +10 points  
Demo request: +25 points  
Pricing page visits: +15 points  

Duplicate Management

Intelligent Duplicate Detection

Pre-Creation Check
Post-Creation Cleanup

Tool: check_existing_contact
Method: GET
URL: https://api.hubapi.com/crm/v3/objects/contacts/search

Search Criteria:
  - Email address (exact match)
  - Phone number (normalized comparison)
  - Company name + last name (fuzzy match)

If match found:
  → update_existing_contact instead of create_new  
  → add lead score instead of overwriting  
  → append conversation history

HubSpot Workflow:
  Trigger: New contact creation  
  Condition: Duplicate score &gt;80%  
  Action: 
    - Suggest merge to sales team  
    - Temporary hold on automated follow-ups  
    - Manual review required tag

Advanced Configurations

Industry-Specific Lead Templates

SaaS/Tech Companies

Additional_Fields:
  tech_stack: "Current software landscape"
  integration_requirements: "Needed integrations" 
  user_count: "Planned number of users"
  compliance_requirements: "GDPR, SOC2, etc."
  current_solution: "Existing solution"
  
Custom_Scoring:
  Enterprise_Size (+20): &gt;500 employees
  High_Tech_Stack (+15): Modern APIs mentioned
  Compliance_Needs (+10): Security/privacy concerns

E-Commerce

Additional_Fields:
  platform_current: "Current e-commerce platform"
  monthly_revenue: "Monthly revenue"
  product_count: "Number of products"
  international_sales: "International sales?"
  growth_challenges: "Main growth obstacles"
  
Custom_Scoring:
  High_Revenue (+25): &gt;100k monthly
  Growth_Stage (+15): "fast-growing"
  Multi_Channel (+10): "Omnichannel"

Professional Services

Additional_Fields:
  service_focus: "Main service area"
  client_size_focus: "Target customer group"
  current_tools: "Currently used tools"
  team_size: "Team size"
  billing_model: "Billing model"
  
Custom_Scoring:
  Established_Practice (+20): &gt;3 years
  Growing_Team (+15): Hiring mentioned
  Process_Pain (+10): Efficiency issues

Multi-Language Support

German_Localization:
  field_labels:
    firstname: "Vorname"
    lastname: "Nachname" 
    company: "Unternehmen"
    jobtitle: "Position"
  
  pain_point_detection:
    efficiency: ["Effizienz", "Produktivität", "Zeitersparnis"]
    cost: ["Kosten", "Budget", "Einsparung", "ROI"]
    growth: ["Wachstum", "Skalierung", "Expansion"]
    competition: ["Konkurrenz", "Wettbewerb", "Marktposition"]

Quality Assurance & Monitoring

Lead Quality Metrics

Metric	Description	Target
Data Completeness	% of leads with complete key data	>90%
Lead Score Accuracy	Correlation of score vs. actual conversion	>0.7
Duplicate Rate	% of duplicates created by the tool	<5%
Sales Acceptance Rate	% of leads accepted by sales	>80%
Speed-to-Lead	Time from call to sales contact	<2 hours

Automated Quality Checks

Data Validation

Pre-Creation Checks:
  - Validate email format  
  - Normalize phone numbers  
  - Check company name against blacklist  
  - Detect spam patterns

Score Validation

Score Plausibility:
  - Check score vs. data completeness  
  - Validate timeline vs. budget consistency  
  - Check authority vs. company size logic

Post-Creation Verification

Automated Follow-up:
  - Email deliverability test  
  - Phone number validation  
  - Company website verification  
  - Social media profile enrichment

Integration Recommendations

Optimize your lead generation with additional tool combinations:

HubSpot Deal Management for sales pipeline management
Webhook Integration for complex multi-system workflows
SendGrid Integration for automated follow-up emails

Pro Tip: Start with a conservative lead scoring algorithm and optimize based on actual conversion data. Overly aggressive scoring can overwhelm the sales team with leads.

Privacy Notice: Ensure all collected leads have explicitly consented to contact and implement GDPR-compliant opt-out mechanisms.

Need a whole toolset instead of building HTTP actions one by one? Connect an external MCP server — tools are discovered automatically. See MCP Servers.

Mid-Call Tools

Mid-Call Tool Integrations

HubSpot Lead Creation

HubSpot Lead Creation Template

Overview & Features

Automatic Lead Capture

BANT Qualification

Configure Lead Creation Tool

1. Basic Tool Setup

2. Request Body Template

3. Parameter Schema

Intelligent Lead Qualification

BANT Framework Implementation

Advanced Lead Enrichment

Company Enrichment Tool

Lead-Company Association

Practical Implementation

Scenario 1: Inbound Lead from Cold Call

Scenario 2: Warm Lead with High Intent

Response Handling & Follow-up

Successful Lead Creation

Automatic Follow-up Workflows

Duplicate Management

Intelligent Duplicate Detection

Advanced Configurations

Industry-Specific Lead Templates

Multi-Language Support

Quality Assurance & Monitoring

Lead Quality Metrics

Automated Quality Checks

Integration Recommendations

​HubSpot Lead Creation Template

​Overview & Features

Automatic Lead Capture

BANT Qualification

​Configure Lead Creation Tool

​1. Basic Tool Setup

​2. Request Body Template

​3. Parameter Schema

​Intelligent Lead Qualification

​BANT Framework Implementation

​Advanced Lead Enrichment

​Company Enrichment Tool

​Lead-Company Association

​Practical Implementation

​Scenario 1: Inbound Lead from Cold Call

​Scenario 2: Warm Lead with High Intent

​Response Handling & Follow-up

​Successful Lead Creation

​Automatic Follow-up Workflows

​Duplicate Management

​Intelligent Duplicate Detection

​Advanced Configurations

​Industry-Specific Lead Templates

​Multi-Language Support

​Quality Assurance & Monitoring

​Lead Quality Metrics

​Automated Quality Checks

Integration Recommendations

HubSpot Lead Creation Template

Overview & Features

Configure Lead Creation Tool

1. Basic Tool Setup

2. Request Body Template

3. Parameter Schema

Intelligent Lead Qualification

BANT Framework Implementation

Advanced Lead Enrichment

Company Enrichment Tool

Lead-Company Association

Practical Implementation

Scenario 1: Inbound Lead from Cold Call

Scenario 2: Warm Lead with High Intent

Response Handling & Follow-up

Successful Lead Creation

Automatic Follow-up Workflows

Duplicate Management

Intelligent Duplicate Detection

Advanced Configurations

Industry-Specific Lead Templates

Multi-Language Support

Quality Assurance & Monitoring

Lead Quality Metrics

Automated Quality Checks