How to Set Up HubSpot Field Mappings

Kevin Doherty

Updated 08 April 2026 08:24

Learn how to set up HubSpot field mappings in Cognism to control exports, map data correctly, and manage update rules.

This guide explains how to configure field mappings, export rules, and update behaviour in Cognism.

By mapping data correctly, you can ensure records are created and updated accurately in HubSpot while maintaining consistent data across your CRM.

Prerequisites

Before you start, you must:

Here is how to set up HubSpot field mappings with the Cognism platform:

Field mappings are configured during the HubSpot integration setup flow.

Export rules control what happens when Cognism finds matching records in HubSpot during an export.

You can configure these rules separately for contacts and companies.

You can select one or more of the following options:

These settings apply to all exports.

Use the Contact step to define how Cognism contact data maps to HubSpot fields.

All standard HubSpot contact fields are supported.

You can also map data to custom HubSpot fields.

If you want to track where records originate, we recommend adding Cognism as a drop down to your existing source field.

Cognism field	Description
First name	Person’s first name
Last name	Person’s last name
Email	Person’s primary email address
Company name	Person’s company name
Job title	Person’s job title
Office phone	Person’s office phone number
Mobile phone	Person’s mobile phone number
City	Person’s city
State	Person’s state
Country	Person’s country
Street	Company street address
Zip code	Company postcode
Website	Company website
Industry	Industry the person works in

Use the Company step to control how company data is sent to HubSpot.

All standard HubSpot company fields are supported.

Additional mappings allow you to populate HubSpot fields with static values.

These values are applied to all exported contacts or companies.

For example, you can map a fixed value, such as Cognism, to a HubSpot source field.

Update rules control how Cognism data is applied to existing HubSpot records.

For each mapped field, choose one of the following:

Only update if blank – Cognism updates the field only if it is empty in HubSpot
Always overwrite – Cognism updates the field every time you export

These settings can affect reporting and data accuracy.

When field mappings are configured: