1. Apollo
  2. Integrations
  3. HubSpot

Configure HubSpot Data Mapping

Article author
Apollo Team
Updated

Overview

Apollo allows you to manually configure and change the way that HubSpot fields are mapped to Apollo fields. This helps ensure that you map data correctly across both systems.

Check out the following sections to update the data mapping between Apollo and HubSpot.

Back to Top

Map Fields

By default, when you connect Apollo to your HubSpot account, Apollo automatically syncs the following fields with HubSpot:

Type Synced Data
Apollo contact push
  • Company
  • Owner
  • First Name
  • Last Name
  • Email
  • Title
  • Phone
  • Address
Apollo account push
  • Owner
  • Name
  • Address
  • Phone
  • Domain from Account
  • Founded Year
HubSpot contact pull
  • Company
  • Owner
  • First Name
  • Last Name
  • Email
  • Title
  • Phone
  • Address
HubSpot account pull
  • Owner
  • Name
  • Address
  • Phone
  • Website/Domain
 
Recommended Defaults

Check out Recommended Default Field Mapping for best practices on how to map default fields to your CRM.

You can customize how you map default and custom fields at any time.

To map fields:

  1. Launch Apollo and click Settings > Integrations.
  2. Select the HubSpot integration.

View HubSpot Integration

  1. Click Contacts, Accounts, or Deals, then click Fields.
  2. Click the HubSpot field you want to map, then select an Apollo field from the dropdown.
  3. Alternatively, click Add field mapping to include any additional fields you want to map between Apollo and HubSpot.

Drop-Down Arrow Example

  1. Repeat this process for any other fields that you want to update.
  2. When finished, click Save.
 
Industry Field Mapping

To avoid errors, HubSpot admin should either create a custom HubSpot property for Apollo industries, or edit the default HubSpot property for industries. Next, download the .txt file of all of Apollo's industries and paste them as picklist values in HubSpot so that the fields match in Apollo.

You have now updated field mapping.

Back to Top

Configure Data Writing Rules

You can configure whether Apollo auto-fills or overwrites contact or account data in your HubSpot fields. By auto-filling or overwriting data in your CRM, you can take full advantage of Apollo's CRM enrichment with updated Apollo data.

To set data writing rules:

  1. Launch Apollo, and click Settings > Integrations > HubSpot.
  2. Click Contacts or Accounts.
  3. Click Data writing rules.

Data writing rules tab highlighted

  1. Select whether to overwrite or auto-fill your HubSpot fields with Apollo data when Apollo pushes records back to your CRM:
    • Auto-fill: Allow Apollo to automatically fill in empty fields for contacts or accounts in HubSpot. Apollo only auto-fills fields when relevant data is available.
    • Overwrite: Allow Apollo to automatically overwrite existing field data for your contacts or accounts. Apollo only overwrites data if relevant information is available and differs from the data already in your HubSpot field.

Auto-fill and overwrite settings highlighted

  1. When finished, click Save.

You have now updated your data writing rules for HubSpot.

Back to Top

Map Apollo Stages

 
Apollo Automapping

While you can manually map Apollo stages to HubSpot, Apollo automapping makes the process quick and easy.

To map your Apollo stages to HubSpot:

  1. Launch Apollo, and click Settings > Integrations > HubSpot.
  2. Click Contacts or Accounts.
  3. Click Stages.
  4. Click Auto-map all stages to automatically map your stages.

Auto-map all stages button highlighted

  1. Alternatively, manually map each stage by matching an Apollo stage to a HubSpot stage or status.

Manual stage mapping for HubSpot stages

  1. Repeat these steps for any other stages you want to map.
  2. When finished, click Save.
 
In Sync

Apollo and HubSpot stages must map one-to-one. If you map a single stage or status to multiple stages, syncing breaks. If you rename, add, or delete a HubSpot stage or status, update the matching stage in Apollo — and reassign any records if you delete a stage entirely. Keeping both platforms aligned ensures accurate stage syncing.

Back to Top

Next Steps

Looking for some more HubSpot content? Here are a few resources to dive into to keep your integration clean, synced, and fully optimized:

Integrate HubSpot with Apollo If you're just getting started, connect HubSpot with Apollo to keep activity, contact, and account data flowing smoothly between both systems.
Configure HubSpot Sync Settings You can fine-tune what moves between platforms by configuring HubSpot sync settings so your team always works with clean, current data.
Important Information About the HubSpot Integration Stay ahead of system behaviors and quirks by reviewing important information about the integration to prevent accidental overwrites or unexpected sync results.

Back to Top