> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytalkvalue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot field mapping

> How HubSpot portal and contact fields map into TalkValue channels and people when you import.

When you import from HubSpot into TalkValue, the integration pulls in two layers: your portal and every contact inside it. Your portal becomes a channel, and your contacts become people. Here's how each field maps.

## Portal mapping

Your HubSpot portal becomes a [channel](/platform/concepts/data-model) in Path. The channel name is the HubSpot portal name.

Every contact imported through that channel is attributed to it, so the [Attribution model](/path/concepts/attribution-model) works without extra setup.

## Contact mapping

Every HubSpot contact becomes a [Person](/platform/concepts/data-model). People are matched by email within your workspace, so a contact that already exists is updated in place instead of duplicated.

| HubSpot field | TalkValue field | Notes                                                                                         |
| ------------- | --------------- | --------------------------------------------------------------------------------------------- |
| Email         | Email           | The identity key. People are matched by email. A contact with no email is not imported.       |
| First name    | First name      | Optional.                                                                                     |
| Last name     | Last name       | Optional.                                                                                     |
| Phone         | Phone           | Optional.                                                                                     |
| Job title     | Job title       | Optional.                                                                                     |
| Company       | Company         | TalkValue also groups people into [companies](/platform/concepts/data-model) by email domain. |
| Profile photo | Avatar          | Optional.                                                                                     |

A contact must have an email to be imported.

## Re-import behavior

You can re-import the same HubSpot portal. TalkValue updates existing people in place by email, adds new contacts, and refreshes the channel. TalkValue never deletes people.

## What is not imported

* **Archived contacts.** Only active contacts are pulled in.
* **Contacts without an email.** Email is the identity key, so a contact with no email is skipped.
* **Address.**
* **HubSpot deal, lifecycle-stage, marketing, or list data.** TalkValue reads only the contact fields listed above.

## Related

* [HubSpot integration](/platform/integrations/hubspot). Connection model, status states, reconnect, disconnect.
* [Import a channel from HubSpot](/platform/integrations/hubspot). Connect HubSpot and start the channel import.
* [Import a CSV](/path/import/csv-quickstart). Manual import path with explicit column mapping.
* [Column mapping](/path/import/column-mapping). The CSV-side counterpart for picking which columns map to which fields.
* [People, companies, channels, events](/platform/concepts/data-model). The Path entity model the import lands in.
