Skip to main content

​
Overview

The HubSpot integration enables automatic account creation when deals close, eliminating manual data entry and ensuring customer data stays synchronized between your CRM and Thread. [SCREENSHOT: HubSpot integration connected status] Caption: HubSpot integration connected and syncing

​
Benefits

Auto-Create Accounts

Deals move to “Closed Won” → Accounts created automatically

No Manual Entry

Customer data flows from HubSpot to Thread automatically

Always Up-to-Date

Changes in HubSpot sync to Thread

Rich Context

CRM notes and history power AI generation

​
Setup Instructions

​
Prerequisites

  • HubSpot Sales Hub (Professional or Enterprise recommended)
  • Admin or Super Admin permissions in HubSpot
  • Thread account with admin role

​
Step 1: Connect OAuth

1

Navigate to Connectors

In Thread: Connectors → Find HubSpot → Click “Connect”
2

Authorize Thread

Redirected to HubSpot → Login if needed → Review permissions → Click “Grant access”Permissions requested:
  • Read deals (to fetch deal data)
  • Read companies (for company info)
  • Read contacts (for customer contacts)
  • Read notes (for context)
3

Confirm Connection

Redirected back to Thread → Green checkmark appears → Status: “Connected”
[SCREENSHOT: HubSpot OAuth authorization screen] Caption: Grant Thread access to your HubSpot data

​
Step 2: Configure Auto-Creation

1

Select Deal Stage

Choose which deal stage triggers account creation:
  • “Closed Won” (recommended)
  • “Contract Signed”
  • Custom stage
Configuration:
  • Navigate to Connectors → HubSpot → Settings
  • Select deal stage from dropdown
  • Save configuration
2

Choose Default Template

Select which template to apply to auto-created accounts:
  • Standard SaaS Onboarding (default)
  • Enterprise Implementation
  • Custom templates
Why this matters: All accounts created from HubSpot will use this template unless manually changed.
3

Map Custom Fields (Optional)

Map HubSpot deal properties to Thread account fields:Default mappings:
HubSpot → Thread
├── Deal Name → Company Name
├── Amount → ARR
├── Close Date → Close Date
├── Primary Contact → Primary Contact
└── Deal Owner → AE Email
Custom mappings: Add your own field mappings for industry, company size, etc.
4

Test with Sample Deal

Create a test deal in HubSpot:
  1. Set stage to your configured trigger stage
  2. Wait 1-2 minutes
  3. Check Thread for new account
  4. Verify data mapped correctly
  5. Delete test account if successful
5

Enable Auto-Creation

Once tested:
  • Toggle “Enable Auto-Creation” to ON
  • All future deals reaching this stage will create accounts
  • Monitor initially for any issues

​
How It Works

​
Webhook Flow

1. Deal reaches "Closed Won" in HubSpot
   ↓
2. HubSpot sends webhook to Thread
   ↓
3. Thread fetches deal data via API
   ↓
4. Thread extracts:
   - Company name
   - Deal amount → ARR
   - Close date
   - Contacts
   - Deal notes
   - Custom properties
   ↓
5. Thread creates account with:
   - Mapped data
   - Selected template
   - Handoff Q&A generation (from notes)
   ↓
6. Handoff email sent to deal owner (AE)
   ↓
7. Account appears in Thread
[SCREENSHOT: HubSpot to Thread data flow diagram]

​
Use Cases

​
1. Sales-to-CS Handoff

Workflow:
  • AE closes deal in HubSpot
  • Thread creates account automatically
  • AI generates handoff Q&A from CRM notes
  • AE reviews and enriches handoff
  • AE assigns CSM
  • CSM starts onboarding
Time saved: 15-20 minutes per account

​
2. Data Synchronization

What syncs:
  • Company name changes
  • Contact updates
  • Deal amount adjustments
  • Close date changes
  • Custom field updates
Frequency: Real-time via webhooks

​
3. Context for AI

CRM data powers:
  • Handoff Q&A generation
  • Email personalization
  • Use case identification
  • Risk detection
  • Stakeholder mapping

​
Field Mappings

​
Standard Mappings

HubSpot FieldThread FieldNotes
Deal NameCompany NameCan customize
AmountARRConverted to annual if needed
Close DateClose DateDate format auto-converted
Company DomainWebsiteOptional
Deal Owner EmailAE EmailFor handoff
Primary ContactPrimary ContactName + email

​
Custom Property Mappings

Add mappings for:
  • Industry (Deal property → Thread industry)
  • Company size (Deal property → Thread company_size)
  • Use case (Deal property → Raw payload for AI)
  • Implementation notes (Deal property → Account notes)
[SCREENSHOT: Field mapping configuration interface]

​
Troubleshooting

​
”Account Not Created”

Problem: Deal closed but no account in Thread Possible causes:
  1. Wrong deal stage (not the configured trigger)
  2. Webhook not received
  3. Missing required fields
  4. Auto-creation disabled
Solutions:
  • Verify deal stage matches configuration
  • Check HubSpot webhook logs
  • Ensure deal has company, amount, close date
  • Check auto-creation toggle is ON
  • Manually trigger if needed

​
”Duplicate Accounts Created”

Problem: Same customer has multiple accounts Possible causes:
  1. Deal stage changed multiple times
  2. Manual account also created
  3. Company name variations
Solutions:
  • Configure to only trigger once per deal
  • Merge duplicate accounts
  • Standardize company names in HubSpot

​
”Missing Data in Account”

Problem: Account created but fields empty Possible causes:
  1. Fields not mapped
  2. Data not in HubSpot
  3. Permissions issue
Solutions:
  • Check field mappings
  • Verify data exists in HubSpot deal
  • Reconnect with full permissions
  • Manually populate critical fields

​
Best Practices

Clean CRM Data First

Standardize company names, formats, and fields before connecting

Test Thoroughly

Create 3-5 test deals to verify mappings work correctly

Document Workflow

Train AEs on the new automated handoff process

Monitor Initially

Check first 10-20 auto-created accounts for issues

Use Deal Notes

Rich notes in HubSpot → Better AI handoff generation

Standard Naming

Consistent deal/company naming improves matching

​
Next Steps

Create Accounts

Understand account creation process

Handoff Process

Learn how HubSpot data powers handoff

AI Generation

See how CRM data improves AI drafts

Slack Integration

Connect Slack for customer notifications