HubSpot Integration on DitLead: Complete Guide to Bidirectional Sync
Keep your HubSpot CRM and DitLead outreach perfectly synchronized. Automatic unsubscribe syncing, list imports, and contact management—all running seamlessly in the background.
Managing contacts across multiple platforms is a recipe for disaster. One person unsubscribes in HubSpot, but your DitLead campaigns keep emailing them. Or worse—someone opts out in DitLead, but HubSpot doesn't know, causing compliance issues and angry recipients.
DitLead's native HubSpot integration solves this by keeping everything in perfect sync automatically. Here's everything you need to know about setting it up and maximizing its potential.
Table of Contents
What is the HubSpot Integration?
DitLead's HubSpot integration is a native, OAuth-based connection that enables seamless data flow between your HubSpot CRM and your DitLead outreach campaigns. Unlike basic integrations that only work one way, DitLead offers true bidirectional synchronization.
Built for Compliance
The integration was specifically designed to help you maintain email compliance. When someone unsubscribes in either platform, both systems update automatically—preventing accidental emails to opted-out contacts.
Key Features & Capabilities
1. Bidirectional Unsubscribe Sync
The crown jewel of this integration. When activated, unsubscribe statuses flow in both directions automatically:
HubSpot → DitLead
- Contacts opted out in HubSpot are automatically marked as unsubscribed in DitLead
- Added to the "HubSpot Unsubscribed" system blocklist
- Existing contacts get the "Unsubscribe" label
- Option to add non-existing contacts to blocklist
DitLead → HubSpot
- Contacts in DitLead blocklists are marked as opted out in HubSpot
- Unsubscribed contacts automatically sync to HubSpot
- Option to create contacts in HubSpot if they don't exist
- Prevents sending to blocked contacts from HubSpot
2. HubSpot List Import
Import entire HubSpot contact lists or dynamic segments directly into DitLead blocklists. Perfect for:
- Blocking competitors from receiving your campaigns
- Excluding customers from cold outreach
- Creating custom exclusion lists based on HubSpot segments
- Automatically syncing as HubSpot lists update
3. Automatic Background Sync
Once configured, the integration runs on autopilot:
- Syncs run every 5 minutes (configurable)
- No manual intervention required
- Real-time EventBridge scheduling ensures reliability
- Detailed sync statistics and monitoring
How to Set Up HubSpot Integration
Setting up the HubSpot integration takes less than 2 minutes. Here's the step-by-step process:
Step 1: Connect Your HubSpot Account
- Navigate to the Apps section in your DitLead workspace
- Find HubSpot in the CRM integrations category
- Click "Connect HubSpot" to initiate OAuth authentication
- Authorize DitLead in the HubSpot popup window
- Done! Your accounts are now connected
Note: The HubSpot integration requires the content OAuth scope to manage email subscriptions. This is automatically requested during setup.
Step 2: Configure Sync Settings
Once connected, click on the HubSpot integration to access settings. You'll see a comprehensive control panel with 4 key toggles:
Sync Configuration Options
Sync to DitLead
Enable syncing FROM HubSpot TO DitLead. When enabled, HubSpot opted-out contacts are added to DitLead's blocklist.
└─ Add Non-Existing to Blocklist
Add contacts to blocklist even if they don't exist in DitLead. Useful for comprehensive unsubscribe management.
Sync to HubSpot
Enable syncing FROM DitLead TO HubSpot. When enabled, DitLead blocklist contacts are marked as opted out in HubSpot.
└─ Create in HubSpot
Create contact in HubSpot if they don't exist and mark as opted out. Ensures complete synchronization.
Pro Tip: All four toggles are enabled by default, providing complete bidirectional synchronization out of the box. You can customize this based on your workflow.
Step 3: Set Sync Interval (Optional)
By default, syncs run every 5 minutes. You can adjust this based on your needs:
- Every 5 minutes: Near real-time sync (recommended)
- Every 15 minutes: Balance between freshness and API usage
- Every 30 minutes: Lower frequency for large contact databases
- Hourly: Minimal API calls, suitable for stable lists
Automatic Unsubscribe Syncing in Action
Let's walk through exactly what happens when someone unsubscribes in either platform:
Scenario 1: Someone Unsubscribes in HubSpot
- Contact opts out: John Doe clicks "unsubscribe" on a HubSpot email
- HubSpot updates: John's
hs_email_optoutfield is set to true - DitLead detects: Next sync cycle (within 5 minutes) fetches all opted-out contacts from HubSpot
- DitLead processes:
- Searches for John in DitLead prospects database
- If found, marks as unsubscribed and adds "Unsubscribe" label
- Adds email to "HubSpot Unsubscribed" system blocklist
- If not found (and toggle enabled), still adds to blocklist
- Result: John will never receive emails from DitLead campaigns
Scenario 2: Someone Unsubscribes in DitLead
- Contact opts out: Jane Smith clicks "unsubscribe" on a DitLead campaign email
- DitLead updates: Jane is marked as unsubscribed and added to blocklist
- HubSpot sync: Next sync cycle identifies all DitLead blocklist contacts
- HubSpot processes:
- Searches for Jane in HubSpot contacts
- If found, marks as opted out of email
- If not found (and toggle enabled), creates contact and marks as opted out
- Result: Jane won't receive marketing emails from HubSpot either
Smart Deduplication
The sync engine is smart enough to avoid duplicates. If a contact is already unsubscribed in both systems, no action is taken. This prevents unnecessary API calls and database updates.
Importing HubSpot Lists to Blocklists
Beyond unsubscribe syncing, you can import entire HubSpot contact lists or segments into DitLead blocklists. This is incredibly useful for maintaining exclusion lists.
How to Import a HubSpot List
- Navigate to Blocklist Settings in your DitLead workspace
- Click "Import from HubSpot" button
- Select a HubSpot list or segment from the dropdown
- Both static lists and dynamic segments are supported
- You'll see the contact count for each list
- Click "Start Import"
- DitLead automatically:
- Creates a new blocklist with the HubSpot list name
- Fetches all contacts from the HubSpot list
- Extracts email addresses
- Adds them to the new blocklist
- Sets up automatic syncing every 5 minutes
Continuous Sync
Once imported, the blocklist stays in sync with your HubSpot list:
- New contacts added to HubSpot list automatically appear in DitLead blocklist
- Removed contacts (in static lists) are reflected in DitLead
- Dynamic segments update based on HubSpot's criteria
- No manual intervention required
Common Use Cases for List Import
🏢 Customer Exclusion
Import your HubSpot "Customers" list to ensure cold outreach campaigns never email existing clients. Maintains professional boundaries and prevents confusion.
🚫 Competitor Blocking
Create a HubSpot list of competitor domains and import it. Automatically blocks all emails from those organizations from receiving your campaigns.
⚖️ Legal Compliance
Import your "Do Not Contact" or "Legal Blocklist" from HubSpot. Ensures compliance with data protection requests across all platforms.
🎯 Segment Exclusion
Use HubSpot's powerful segmentation to create dynamic exclusion lists. For example, "Churned Customers in Last 90 Days" or "Unresponsive Leads."
Real-World Use Cases
Use Case 1: SaaS Company with Multi-Touch Campaigns
Challenge: A SaaS company runs both HubSpot marketing automation and DitLead cold outreach. They need to ensure unsubscribes are honored across both platforms.
Solution: Enable bidirectional unsubscribe sync with all toggles on.
Result: When prospects unsubscribe from either HubSpot nurture campaigns or DitLead cold emails, they're immediately removed from all campaigns. Improved deliverability and compliance.
Use Case 2: Agency Managing Multiple Clients
Challenge: An agency stores client contacts in HubSpot and runs outreach for prospects in DitLead. They need to prevent accidentally emailing their own clients.
Solution: Import HubSpot "Clients" list as a blocklist. Enable automatic sync.
Result: As new clients are added to HubSpot, they're automatically excluded from DitLead campaigns within 5 minutes. Zero risk of embarrassing emails.
Use Case 3: Enterprise with Strict Compliance Requirements
Challenge: An enterprise needs to maintain a centralized unsubscribe list across all tools for GDPR compliance.
Solution: Use HubSpot as the source of truth. Enable "Sync to DitLead" with "Add non-existing to blocklist" turned on.
Result: All unsubscribes flow from HubSpot to DitLead automatically. Single source of truth for compliance audits.
Best Practices & Tips
1. Start with Full Bidirectional Sync
Unless you have a specific reason not to, enable all four sync toggles. This provides the most comprehensive protection and ensures consistency across platforms.
2. Use HubSpot Segments for Dynamic Exclusions
Instead of static lists, create dynamic HubSpot segments for imports. For example:
- "Lifecycle Stage is Customer" - Automatically excludes new customers
- "Last Email Click Date is less than 90 days ago" - Excludes recently engaged contacts
- "Contact Owner is [Your Team]" - Excludes contacts being worked by sales
3. Monitor Sync Statistics
The HubSpot settings panel shows detailed sync statistics:
- Last sync timestamp
- Total contacts synced
- Error count
- Sync duration
Check these regularly to ensure everything is running smoothly.
4. Set Appropriate Sync Intervals
High-Volume Operations: Keep at 5 minutes for near real-time sync
Medium-Volume: 15-30 minutes is usually sufficient
Low-Volume/Stable Lists: Hourly sync reduces API overhead
5. Review Active Imports Periodically
In the Blocklist settings, you'll see all active HubSpot imports. Review these monthly to:
- Remove obsolete imports
- Update import configurations
- Pause unnecessary syncs
6. Test Before Going Live
Before enabling the integration on your main workspace:
- Create a test HubSpot list with a few contacts
- Import it to DitLead
- Mark a contact as unsubscribed in HubSpot
- Wait 5 minutes and verify it appears in DitLead blocklist
- Test the reverse direction
Frequently Asked Questions
Does the integration work with HubSpot Free?
Yes! The integration works with all HubSpot tiers including Free, Starter, Professional, and Enterprise.
How often do syncs run?
By default, syncs run every 5 minutes. You can adjust this to 15 minutes, 30 minutes, or hourly based on your needs.
What happens if the sync fails?
The integration automatically retries failed syncs. Error details are logged and displayed in the sync statistics. You'll be notified if persistent errors occur.
Can I sync specific HubSpot properties?
Currently, the integration focuses on email addresses and unsubscribe status. Full contact property syncing is planned for a future update.
Does this affect my HubSpot API limits?
The integration is optimized to minimize API calls. It uses batch operations and only syncs changed data. For most accounts, this uses less than 5% of HubSpot's daily API limit.
Can I pause the sync temporarily?
Yes! Simply toggle off "Automatic Unsubscribe Sync" in the HubSpot settings. You can re-enable it anytime without losing your configuration.
What happens if I disconnect HubSpot?
Disconnecting HubSpot stops all syncs immediately. Previously synced data remains in DitLead. Imported blocklists become static (no longer sync with HubSpot).
Is the integration secure?
Absolutely. The integration uses OAuth 2.0 for authentication (never stores your HubSpot password), encrypted data transmission, and follows security best practices. DitLead is SOC 2 compliant.
Get Started with HubSpot Integration
DitLead's HubSpot integration transforms how you manage contacts across platforms. No more manual exports, no more compliance worries, no more duplicate work.
Ready to Connect HubSpot?
Set up the integration in under 2 minutes and start syncing immediately. Available on all DitLead plans.