Automatically sync leads from Viewers to HubSpot. When someone submits their information through your widget, a new Contact is created in HubSpot with all their details - ready for your sales and marketing teams to work.
This integration requires a PRO plan.
How It Works
When a lead is captured on your site, Viewers creates a new Contact in HubSpot with the contact’s name, email, company information, and any enrichment data. Your team sees new leads in HubSpot without any manual data entry - ready for workflows, sequences, and follow-up.
What You’ll Need
- A HubSpot account with access to Private Apps
- Your HubSpot Access Token
Creating a HubSpot Private App
- In HubSpot, go to Settings (gear icon)
- Navigate to Integrations → Legacy Apps
- Click Create Legacy App and select Private
- Name it
Viewers.comand click Scopes - Search for
contactsand check these scopes:- crm.objects.contacts.read (View contacts)
- crm.objects.contacts.write (Create/update contacts)
- Click Update, then Create App
- Click the Auth tab
- Copy your Access Token
Keep this token private - it grants access to your HubSpot contacts.
Setting Up the Integration
- Log in to your Viewers dashboard
- Go to Automations
- Find HubSpot and click to configure
- Paste your HubSpot Access Token
- Select which contact types to sync (see below)
- Choose your sync type (see below)
- Save your settings
Configuration Options
Contact Types to Sync
Choose which modules should create Contacts in HubSpot:
- Chat - AI chat conversations
- Signup - Newsletter signups
- Coupon - Spin to Win / discount entries
- Feedback - Feedback submissions
- Share - Social share submissions
- Contact - Contact form submissions
- Custom - Custom module submissions
Select the modules that represent meaningful leads for your sales and marketing process. For example, Chat and Contact submissions might go to sales, while Signup leads go into marketing nurture workflows.
Sync Type
Control which leads get synced to HubSpot:
All Valid Emails Syncs all contacts with verified email addresses. Use this if you want every lead in HubSpot regardless of whether they have company data.
Enriched Leads Only Only syncs contacts that have company/contact enrichment data (company name, phone, website, etc.). This filters out personal email addresses and leads without business information.
Use enriched-only if your sales team only wants qualified B2B leads with company context.
What Gets Synced to HubSpot
When a Contact is created in HubSpot, these fields are mapped:
| Viewers Field | HubSpot Property |
|---|---|
name | First Name / Last Name |
email | |
company.name | Company |
company.phone | Phone Number |
company.website | Website |
question | Notes or custom property |
page_url | Original Source |
Enrichment data like employee count and revenue can be mapped to custom HubSpot properties if you’ve created them.
Best Practices
Use “Enriched Leads Only” for cleaner data If your sales team gets frustrated by leads without company information, filter them out at the source. Only qualified leads with business data hit HubSpot.
Create custom properties for enrichment data HubSpot’s standard Contact properties don’t include fields like employee count or revenue. Create custom properties to capture this valuable data.
Set up HubSpot workflows Use HubSpot workflows to automatically assign owners, send notifications, enroll contacts in sequences, or update lifecycle stages when new Viewers leads arrive.
Use Lead Source tracking Create a custom property or use HubSpot’s built-in source tracking to identify contacts that came from Viewers. This helps with attribution and reporting.
Segment by module type Use the module information to segment leads - Chat leads might get a different follow-up sequence than Newsletter signups.
Troubleshooting
Leads not appearing in HubSpot?
- Double-check your Access Token is correct and complete
- Make sure the integration is saved and enabled in Viewers
- Verify the lead type you’re testing is selected in “Contact Types to Sync”
- Check that your Private App has the correct scopes (contacts read and write)
Access Token not working?
- Tokens can be regenerated - make sure you’re using the current one
- Verify the Private App is still active in HubSpot
- Check that the required scopes are enabled
Duplicate contacts being created?
- HubSpot deduplicates by email address - it shouldn’t create duplicates
- Existing contacts will have their data updated instead
- Check HubSpot’s duplicate management settings
Missing fields in HubSpot?
- Standard HubSpot properties are limited - create custom properties for enrichment data
- Some leads won’t have company data (personal emails, new businesses)
Frequently Asked Questions
Does this create Contacts or Deals? Contacts. Viewers creates new Contact records in HubSpot. Use HubSpot workflows to automatically create associated Deals if needed.
Will it update existing Contacts? Yes. If the email already exists in HubSpot, the Contact’s information is updated with the new data rather than creating a duplicate.
How quickly do leads sync? Immediately when a lead is captured (for “All Valid Emails”). For “Enriched Leads Only,” there may be a brief delay while enrichment completes.
Can I sync to a specific list or lifecycle stage? The integration creates Contacts. Use HubSpot workflows to automatically add them to lists or set lifecycle stages based on criteria.
Will this trigger HubSpot workflows? Yes. Creating a Contact through Viewers triggers workflows the same as any other contact creation method.
What HubSpot plans support Private Apps? Private Apps are available on most HubSpot plans. Check your HubSpot account settings to confirm you have access.
Need Help?
If you have questions about connecting Viewers to HubSpot, contact us.