# HubSpot Field Mapping

To start setting up your field mappings click into the Contacts field tab in your integration settings.

<figure><img src="https://3940976487-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhZY7WR46v9ngHXb5FbhZ%2Fuploads%2FsJfZGfno7blB1SbULXiD%2FScreenshot%202025-12-22%20at%209.46.56%E2%80%AFAM.png?alt=media&#x26;token=cc4a9a65-d253-42c4-bfec-6c1eb0f73575" alt=""><figcaption></figcaption></figure>

The following are the default Lead mappings. You can customize these mappings to include lead qualifiers and enriched data.

| Popl Field                                                                   | HubSpot Field |
| ---------------------------------------------------------------------------- | ------------- |
| first name                                                                   | First Name    |
| last name                                                                    | Last Name     |
| email                                                                        | Email         |
| job title                                                                    | Job Title     |
| company                                                                      | Company       |
| number                                                                       | Phone Number  |
| Contact Owner (will be the member that connected with that contact via Popl) | Contact Owner |

**Note: The&#x20;*****Record Source*****&#x20;field in HubSpot is automatically populated by HubSpot to show the origin of a contact. You do not need to map this field from Popl. HubSpot will fill it in for you.**

#### Customize your Field Mappings

You can modify or replace the default mappings with your own custom mappings including lead qualifiers and enriched data. To add a new field mapping, click **Add Mapping** in the top-right corner of the Contact field mapping tab.

<figure><img src="https://3940976487-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhZY7WR46v9ngHXb5FbhZ%2Fuploads%2FTGPDXCjvQxb7FmvWvbI8%2FScreenshot%202025-12-22%20at%209.41.08%E2%80%AFAM.png?alt=media&#x26;token=a79a7b52-9ced-4183-ae73-98b500e3f65e" alt=""><figcaption></figcaption></figure>

#### Sync Logic For Contacts

After choosing which fields you want to map, you can adjust the sync behavior. You can choose between overwrite, complete if missing, or append.

**Overwrite field:** If a value already exists for an object in HubSpot, replace that data with the Popl field.&#x20;

**Complete if missing:** Only use the Popl value if the existing field is empty. Otherwise leave the field value as is in HubSpot.

**Append:** Add Popl values to fields that may already have data, instead of replacing it.

***

#### Mapping Types

**Dynamic Mappings -** Dynamic mappings allow Popl to send **real-time data** from each individual contact into the corresponding HubSpot field. This means the value that syncs will **change based on the information captured** during the lead exchange.Use dynamic mappings when you want HubSpot fields to reflect unique data for every synced record.

**Fixed Mappings** - Fixed mappings allow you to send the **same preset value** to a HubSpot field for every synced record. To set a fixed mapping, click into the Popl field, select **“Fixed Mapping,”** and enter the constant value you want applied to all synced contacts. Use fixed mappings when you need a **consistent, unchanging value.**

<figure><img src="https://3940976487-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhZY7WR46v9ngHXb5FbhZ%2Fuploads%2FIflkGNMVeoqcYCSKbGsQ%2FScreenshot%202025-12-23%20at%209.59.44%E2%80%AFAM.png?alt=media&#x26;token=904c639f-e882-42d5-90e8-319f7292bbb9" alt=""><figcaption></figcaption></figure>

***

#### Save Settings

Once you have configured your field mappings, be sure to save your changes. You can do this by clicking **Save** in the top-right corner of the contact mapping tab.

<figure><img src="https://3940976487-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhZY7WR46v9ngHXb5FbhZ%2Fuploads%2FpxtAbNMlvSzym4Y40ouz%2FScreenshot%202025-12-23%20at%2010.05.45%E2%80%AFAM.png?alt=media&#x26;token=73ac6c7a-5860-4613-93d5-f82b1b5e7ea4" alt=""><figcaption></figcaption></figure>

Once your mappings and sync behaviors are set, your integration runs seamlessly, automatically delivering the right data to the right HubSpot fields every time.&#x20;

***

#### Need Help?

Contact Popl Support – our team is available to assist at <teams@popl.co>.

\
With 🤍 from Popl.&#x20;