Field Mappings
Understand how to configure and use HubSpot field mappings in Unify.
Overview
Unify can sync data between HubSpot objects and Unify objects. However, the exact fields in HubSpot differ from Unify, so Unify needs to understand how to sync data between the two systems. This is done using field mappings.
Setup
Change field mappings
When you first connect your HubSpot instance, Unify will automatically prepare the field mappings for you. If you use any custom properties in place of default HubSpot properties, you may want to update the mappings before Unify starts syncing data.
In the HubSpot integration settings, look for the Company, Person, and Email Message field mappings at the bottom of the page. Select one to view and edit the field configuration.
Customize which fields are synced to and from HubSpot.
You can return to update these mappings any time in the future, so you don’t need to worry about getting them perfect right off the bat!
(Optional) Create custom properties
You can write values to default properties and custom properties. In order to write to custom properties, they must already exist in HubSpot.
While some of the fields Unify can write exist as standard properties in HubSpot, many of them do not. In particular, Unify-specific fields (like the name of the Sequence a person was enrolled in) do not exist in HubSpot by default. In order to write these values to HubSpot, you will need to create custom properties before mapping them.
Here’s what the process looks like for adding Contact properties. First, in HubSpot, navigate to CRM -> Contacts.
Select Actions -> Edit properties.
Navigate to Groups -> Create group.
Type in the name of the group (recommended title “Unify information”) and click Create.
Navigate to Properties -> Create property.
When editing the property details, make sure the Object type is set properly (in this case, to Contact) and the Group is set to the group you created earlier. You can fill in the Label and Description as desired.
Lastly, select the Field type and click Create.
This is what your Contact properties filtered to your new group might look like after you’ve added them:
You can then repeat this process for Company properties as well.
Available fields
Below is a full list of the values that can be configured in the field mappings for each object type. Some of these are standard properties, while others provide Unify-specific information, such as the name of the Sequence that a person was enrolled in.
Companies
Companies
Field | Description |
---|---|
Company Name Text | Name of the company. |
Domain Text | Web domain of the company. |
Address Text | Physical address of the company. |
State or Province Text | State, province, region, or territory the company is located in. |
Country Country | Country the address is located in. |
City Text | City, town, or village the company is located in. |
Postal Code Text | Postal code for the company. |
Time Zone Text | Time zone the company is located in. |
Corporate Phone Text | Corporate phone number for the company. |
Status Text | Status of the company in the sales lifecycle. |
LinkedIn URL Text | URL to the company’s LinkedIn page. |
Description Text | Description of the company. |
Do Not Contact Boolean | Flag indicating that the company should not be contacted. |
Founded Date | Date the company was founded. |
Industry Text | Industry the company is in. |
Employee Count Number | Approximate number of employees at the company. |
Revenue Number | Estimated annual revenue of the company. |
Revenue Currency Text | Three-letter ISO 4217 code indicating the revenue value currency type. |
Account Source Text | Channel this Company record was sourced from. |
Unify Metadata Text | A unique identifier useful for tracking records that Unify writes to. |
Unify Created At Date | Date and time the record was created by Unify. This will only be populated if Unify created the record; otherwise, it will remain empty. |
Unify Updated At Date | Date and time the record was last updated by Unify. |
Unify First Written At Date | Date and time the record was first written to by Unify. This will be populated when Unify first creates or updates the record, and it will not change after that. |
Unify Initial Play Text | Name of the first Unify Play that ran on this record. |
Unify Initial Play At Date | Date and time the first Unify Play ran on this record. |
Unify Most Recent Play Text | Name of the most recent Unify Play that ran on this record. |
Unify Intent Level Text | Intent level of the company (either High, Medium, Low, or None). |
People
People
Field | Description |
---|---|
Email Text | Contact email address. |
Address Text | Physical address of the person. |
Country Country | Country the address is located in. |
Postal Code Text | Postal code for the person. |
Email Opt Out Boolean | Indicates whether the person has opted out of receiving emails. |
Status Text | Status of the person in the sales lifecycle. |
First Name Text | First name of the contact. |
First Name Suffix Text | Suffix of the first name of the contact. |
Last Name Text | Last name of the contact. |
Title Text | Job title or position of the contact. |
Mobile Phone Text | Mobile phone number of the contact. |
Work Phone Text | Work phone number of the contact. |
Corporate Phone Text | Corporate phone number of the contact. |
LinkedIn URL Text | LinkedIn profile URL of the contact. |
Do Not Call Boolean | Indicates whether the contact should receive phone calls or not. |
Do Not Email Boolean | Indicates whether the contact should receive emails or not. |
EU Resident Boolean | Indicates whether the contact is a resident of the European Union. |
Lead Source Text | Channel this Person record was sourced from. |
Last Activity Date Date | Date of the last activity or engagement with the contact. |
Unify Metadata Text | A unique identifier useful for tracking records that Unify writes to. |
Unify Created At Date | Date and time the record was created by Unify. This will only be populated if Unify created the record; otherwise, it will remain empty. |
Unify Updated At Date | Date and time the record was last updated by Unify. |
Unify First Written At Date | Date and time the record was first written to by Unify. This will be populated when Unify first creates or updates the record, and it will not change after that. |
Unify Initial Play Text | Name of the first Unify Play that ran on this record. |
Unify Initial Play At Date | Date and time the first Unify Play ran on this record. |
Unify Most Recent Play Text | Name of the most recent Unify Play that ran on this record. |
Unify Most Recent Play At Date | Date and time the most recent Unify Play ran on this record. |
Unify Initial Sequence Text | Name of the first Unify Sequence this person was enrolled in. |
Unify Initial Sequence At Date | Date and time this person was first enrolled in a Unify Sequence. |
Unify Initial Sequence Step At Date | Date and time this person first completed a step in a Unify Sequence. |
Unify Most Recent Sequence Text | Name of the most recent Unify Sequence this person was enrolled in. |
Unify Most Recent Sequence At Date | Date and time this person was most recently enrolled in a Unify Sequence. |
Unify Most Recent Sequence Step At Date | Date and time this person most recently completed a step in a Unify Sequence. |
Unify Most Recent Sequence Status Text | Status of the most recent enrollment for this person. The statuses shown on enrollments in Unify are the same values that will be written to HubSpot. |
Email Messages
Email Messages
Field | Description |
---|---|
Universal Message ID Text | Globally unique identifier that exists for all email messages. |
Sender Text | Reference to the user, contact, or lead who sent the email. |
Recipients Text[] | List of users, contacts, or leads who received the email. |
Subject Text | Subject of the email. |
Content Text | Body of the email. |
Sent At Date | Date and time the email was sent. |
Is Bounced Boolean | Indicates whether the email bounced. |
Bounced At Date | Date and time the email bounced. |
Click Count Number | Number of times a link in the email was clicked. Only links to sites with the Unify intent client are tracked. |
Clicked At Date | Date and time a link in the email was first clicked. |
Is Marked as Spam Boolean | Indicates whether the email was marked as spam by a recipient. |
Marked As Spam At Date | Date and time the email was marked as spam by a recipient. |
Is Opened Boolean | Indicates whether the email was opened by a recipient. |
First Opened At Date | Date and time the email was first opened by a recipient. |
Last Opened At Date | Date and time the email was last opened by a recipient. |
Track Opens Boolean | Indicates whether open tracking was enabled for the email. |
Is Opted Out Boolean | Indicates whether the recipient opted out of receiving emails. |
Opted Out At Date | Date and time the recipient opted out of receiving emails. |
Enrolled By Play Text | Name of the Play that enrolled the recipient in the sequence. |
Sequence Name Text | Name of the sequence linked to the email. |