Coming Soon

HubSpot integration is rolling out — write-back of enriched fields to your HubSpot portal.

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 credits on it (top up from £2.49)
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 → HubSpot
2.Click "Connect with HubSpot" — you'll be redirected to HubSpot
3.Sign in to HubSpot, choose the portal to connect, and authorize ABM.dev
4.You'll be sent back to ABM.dev with the connection live — no API keys to manage

Prefer a Private App token?

Power users can connect with a HubSpot Private App token instead — in the Connect dialog choose "Enter a Private App token instead". The token needs the same Contacts and Companies read/write scopes.

Go to HubSpot Settings

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/api/v2/enrichments \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "targets": [
      { "type": "person", "email": "[email protected]" }
    ],
    "options": {
      "auto_writeback": true,
      "create_in_crm_if_missing": 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 create_in_crm_if_missing 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