Connecting HubSpot
Sync your HubSpot contacts, companies, and deals directly to Airtable. This guide covers the complete OAuth setup process for HubSpot integration.
Before You Begin
- You need a HubSpot account (Free CRM or any paid plan)
- You should have appropriate permissions in HubSpot (admin or user with app marketplace access)
- Make sure you've already connected Airtable to TableSync
[Screenshot: HubSpot logo and TableSync integration overview]
Step-by-Step Connection Guide
Step 1: Find HubSpot in Sources
- Log in to your TableSync Dashboard
- Scroll down to the Sources section
- Find the HubSpot card (orange icon)
[Screenshot: Dashboard Sources section with HubSpot card highlighted]
Step 2: Start the Connection
- Click the Connect button on the HubSpot card
- A new window will open for HubSpot authorization
- If you're not logged in, you'll see the HubSpot login page
[Screenshot: HubSpot Connect button and initial popup]
Step 3: Choose Your HubSpot Account
If you have multiple HubSpot accounts:
- You'll see a list of HubSpot portals you have access to
- Select the account you want to connect
- Click Choose Account
[Screenshot: HubSpot account selection screen]
Tip: Make sure you select the account that contains the data you want to sync.
Step 4: Review Permissions
HubSpot will show you what TableSync is requesting:
- Review the list of permissions
- TableSync requests read-only access to:
- CRM objects (contacts, companies, deals)
- Basic account information
- Click Connect app or Grant access
[Screenshot: HubSpot permissions review screen]
Important: TableSync never writes to, modifies, or deletes any of your HubSpot data.
Step 5: Confirm Connection
- You'll be redirected back to TableSync
- The HubSpot card will show Connected with a green indicator
- Your HubSpot portal name will appear below the status
[Screenshot: Connected HubSpot card showing portal name]
Available Data Types
Once connected, you can sync these HubSpot objects to Airtable:
Contacts
| Field | Description |
|---|---|
| Primary email address | |
| First Name | Contact's first name |
| Last Name | Contact's last name |
| Phone | Phone number |
| Company | Associated company name |
| Job Title | Contact's title |
| Created Date | When the contact was created |
| Last Modified | When the contact was last updated |
Companies
| Field | Description |
|---|---|
| Company Name | Official company name |
| Domain | Company website domain |
| Industry | Business industry |
| Phone | Company phone number |
| City | Location city |
| State | Location state/region |
| Country | Location country |
Deals
| Field | Description |
|---|---|
| Deal Name | Name of the deal |
| Amount | Deal value |
| Deal Stage | Current pipeline stage |
| Close Date | Expected close date |
| Pipeline | Which pipeline the deal is in |
| Owner | Assigned sales rep |
Note: Custom properties you've created in HubSpot will also be available for syncing.
HubSpot Plan Compatibility
| HubSpot Plan | Compatible? | Notes |
|---|---|---|
| Free CRM | Yes | All standard objects available |
| Starter | Yes | All features included |
| Professional | Yes | Custom objects may be available |
| Enterprise | Yes | Full API access |
Permission Levels
You don't need to be a Super Admin to connect TableSync:
| Your HubSpot Role | Can Connect? |
|---|---|
| Super Admin | Yes |
| Admin | Yes |
| User with App Marketplace | Yes |
| Standard User | May need admin approval |
If you can't connect, ask your HubSpot admin to either:
- Grant you App Marketplace permissions
- Connect TableSync on your behalf
Troubleshooting
"Access denied" or "Insufficient permissions"
Possible causes:
- Your HubSpot user doesn't have permission to install apps
- The HubSpot portal has app installation restrictions
Solutions:
- Ask your HubSpot admin to grant you App Marketplace access
- Have an admin connect TableSync instead
- Check if your organization has restrictions on third-party apps
"I selected the wrong HubSpot account"
Solution:
- Go to your TableSync Dashboard
- Click the three-dot menu on the HubSpot card
- Select Disconnect
- Reconnect and select the correct account
"My custom fields aren't showing up"
Possible causes:
- Custom properties may take a moment to sync
- Some property types might not be supported
Solutions:
- Wait a few minutes and refresh the page
- Try creating a new sync - custom fields load during sync creation
- Contact support if specific fields are missing
"Connection shows expired"
HubSpot connections can expire if:
- You revoked access in HubSpot settings
- Your HubSpot subscription changed
- The API token expired (rare)
Solution: Click Reconnect on the HubSpot card.
Managing Your HubSpot Connection
Viewing Connection Status
Your Dashboard shows:
- Connection status (Connected/Disconnected)
- Portal name
- When the connection was established
Disconnecting HubSpot
To remove the HubSpot connection:
- Click the three-dot menu on the HubSpot card
- Select Disconnect
- Confirm the disconnection
Warning: Disconnecting will pause all syncs using this HubSpot connection.
Revoking Access from HubSpot
You can also remove TableSync directly from HubSpot:
- Log in to HubSpot
- Go to Settings (gear icon)
- Navigate to Integrations > Connected Apps
- Find TableSync and click Uninstall
Frequently Asked Questions
Will TableSync affect my HubSpot usage limits?
TableSync uses HubSpot's API, which has rate limits. For most users, this isn't an issue. If you have a very high sync frequency and large data volumes, you might approach limits on the free plan.
Can I sync HubSpot data to multiple Airtable tables?
Yes! You can create separate syncs for contacts, companies, and deals, each going to different Airtable tables.
How often can I sync HubSpot data?
Depends on your TableSync plan:
- Free: Daily syncs
- Starter: Hourly syncs
- Pro/Team: Every 15 minutes
Will syncing create duplicates in Airtable?
No. TableSync uses email (for contacts) or unique IDs to match records. Existing records are updated, not duplicated.
Can I sync from multiple HubSpot portals?
Each TableSync account can connect one HubSpot portal. If you need multiple portals, consider separate TableSync accounts or contact support for enterprise options.
Does TableSync support HubSpot custom objects?
Standard objects (contacts, companies, deals) are fully supported. Custom objects support is being developed - contact support for the latest status.