Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.enrichley.io/llms.txt

Use this file to discover all available pages before exploring further.

The Enrichley HubSpot integration is in beta. Setup steps and capabilities may evolve as we add features.
The Enrichley HubSpot integration lets you move contacts and companies between Enrichley and HubSpot so you can validate, enrich, and clean data before it powers your campaigns.

Import

Pull contacts, companies, and lists from HubSpot into Enrichley for validation and enrichment.

Export

Push validated and enriched data back to HubSpot — with field mapping, duplicate handling, and a guided wizard.

Custom properties

Create custom HubSpot properties on the fly during export to capture validation results and enrichment fields.

​
Plan requirements

The HubSpot integration is available on Professional, Scale, Advanced, Growth, and Ultimate Enrichley plans. Starter plans do not include HubSpot access — upgrade your plan to enable the integration. You also need permission inside HubSpot to authorize OAuth applications.

​
Connect HubSpot

1

Open the HubSpot integration

In Enrichley, go to Integrations → HubSpot and click Connect.
2

Sign in to HubSpot

You’ll be redirected to HubSpot’s login page. Sign in with your HubSpot credentials.
3

Choose your HubSpot account

If you have access to multiple HubSpot accounts, select the one you want to connect and click Choose Account.
4

Review and approve permissions

Review the permissions Enrichley is requesting — read and write access to contacts, companies, and lists. Click Connect app to approve.
5

Acknowledge the unverified app warning

Type “I accept the risk” in the text field and click Connect to proceed past HubSpot’s verification warning.
6

Confirm the connection

You’ll see a success message and be redirected back to Enrichley. Your Hub Domain and granted scopes will appear on the HubSpot integration page.

​
Using the integration

All imports and exports are manual — there are no automated syncs. You control when data moves between Enrichley and HubSpot.

​
Import from HubSpot

Pull HubSpot data into Enrichley to validate or enrich it. You can import:
  • Contacts — contact records from your HubSpot CRM
  • Companies — company records from your HubSpot CRM
  • Lists — specific HubSpot contact lists
Imports are available from the email validation, people search, and company search workflows in Enrichley.

​
Export to HubSpot

Push validated and enriched data back to HubSpot using the guided 8-step export wizard:
1

Select source

Pick a saved snapshot or completed validation job as the source data.
2

Map fields

Map your Enrichley columns to HubSpot contact or company properties. Save mappings to reuse them on future exports.
3

Preflight validation

Enrichley shows you matches, conflicts, and how many records will be created vs. updated.
4

Resolve duplicates

For ambiguous matches, choose how to handle each one (update, skip, or create new).
5

Review matches

Final review before execution.
6

Prepare

If you mapped fields to properties that don’t exist yet, Enrichley creates the custom HubSpot properties for you.
7

Run

Execute the export job. Progress streams in real time on the Sync History page.
8

Done

Review the completion summary — records created, records updated, any failures.

​
Custom HubSpot properties

When you map an Enrichley field to a HubSpot property that doesn’t exist, Enrichley can create it for you during the Prepare step (requires the crm.schemas.*.write scope, which is requested by default). Custom properties you create through Enrichley follow HubSpot’s naming conventions (lowercase, alphanumeric, underscores) and are typically grouped under an enrichley_* prefix so they’re easy to find in HubSpot.

​
Saved field mappings

Save your field mappings during the export wizard to reuse them on future exports without remapping every column.

​
Sync history

Every export job appears on the Sync History page with status (queued, running, succeeded, failed), progress, and a link to the detailed job page where you can see per-record results.

​
Limits

LimitDefault
Records per import50,000
Records per filtered validation10,000
If you need higher limits, contact support@enrichley.io.

​
Disconnect

You can disconnect HubSpot from Enrichley at any time.
1

Open the HubSpot integration page

Go to Integrations → HubSpot in Enrichley.
2

Click Disconnect

Confirm the disconnection when prompted.
Disconnecting removes the ability to import or export data between Enrichley and HubSpot. Your HubSpot data is not affected — Enrichley only loses access.

​
Delete integration data

If you also want to remove all integration data Enrichley has stored (saved mappings, import/export history, job logs), use Delete All Data in the Danger Zone section of the HubSpot integration page.
Deleting integration data does not alter your HubSpot account. It only removes data Enrichley has stored about your past imports, exports, and mappings.

​
Uninstall from HubSpot

To remove Enrichley from your HubSpot account entirely:
1

Open HubSpot Settings

In HubSpot, go to Settings.
2

Open Connected Apps

Navigate to Integrations → Connected Apps.
3

Find Enrichley

Locate Enrichley in your list of connected apps.
4

Uninstall

Click the Actions dropdown and select Uninstall.
Uninstalling Enrichley does not affect your HubSpot data. You can reconnect anytime by following the setup steps above.

​
Get help

If you run into trouble or have questions about the HubSpot integration, contact support@enrichley.io.