10 minIntegration

HubSpot Integration

Connect your HubSpot CRM to automatically sync enriched contact and company data.

In this guide

Connect your HubSpot account via OAuth
Configure field mapping between ABM.dev and HubSpot
Set up automatic enrichment sync
Test the integration with a sample contact

Prerequisites

An ABM.dev account with an active subscription
A HubSpot account with admin or super admin access
HubSpot Marketing Hub or Sales Hub (Professional or Enterprise recommended)

Connect your HubSpot account

Navigate to your ABM.dev settings and initiate the HubSpot connection:

1.Go to Settings → Integrations
2.Click "Connect HubSpot"
3.Sign in to HubSpot and authorize ABM.dev
4.Select the HubSpot portal you want to connect

Go to Integrations

OAuth Permissions

ABM.dev requests read and write access to Contacts and Companies. This is required to sync enriched data back to your CRM.

Configure field mapping

After connecting, map ABM.dev enrichment fields to your HubSpot properties. We automatically suggest mappings for standard fields.

ABM.dev Field	HubSpot Property	Type
`person.fullName`	firstname + lastname	Contact
`person.title`	jobtitle	Contact
`person.linkedinUrl`	linkedinbio	Contact
`company.name`	company	Contact/Company
`company.industry`	industry	Company
`company.employeeCount`	numberofemployees	Company

Custom Properties

You can create custom HubSpot properties for ABM.dev-specific fields like confidence scores and enrichment timestamps.

Configure sync settings

Choose how enriched data should be synced to HubSpot:

Auto-Sync

Automatically write enriched data to HubSpot after each enrichment. Best for real-time data freshness.

Manual Approval

Review enriched data before syncing. Best when data quality review is required.

Confidence Threshold

Set a minimum confidence score for automatic updates. We recommend 0.85 for automated workflows to ensure high data quality.

Test the integration

Run a test enrichment and verify the data syncs correctly:

Test enrichment with HubSpot sync

curl -X POST https://api.abm.dev/v1/enrich \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "syncTo": {
      "hubspot": {
        "enabled": true,
        "createIfMissing": true
      }
    }
  }'

Check your HubSpot portal to verify the contact was created or updated with the enriched data.

Troubleshooting

Data not syncing

• Check that your HubSpot connection is still active in Settings
• Verify the confidence score meets your threshold
• Ensure the contact email exists or createIfMissing is enabled

Permission errors

• Re-authorize the HubSpot connection with an admin account
• Check that ABM.dev has the required scopes

Next Steps

LinkedIn Integration

Set up profile enrichment

How Enrichment Works

Understanding confidence scores