1. [Help](https://nuvia.ai/en/docs) 2. [Integrations](https://nuvia.ai/en/docs/colecoes/19378002-integrations) 3. [HubSpot](https://nuvia.ai/en/docs/colecoes/19431232-hubspot) # How to map fields between Nuvia and HubSpot How to create field mappings, organize the list in large accounts, and avoid the silent failure of dropdown and multiple choice fields. Available on Platform > Integrations > HubSpot > Fields Who can do it Admin Module: Platform Updated on September 9, 2026 [HubSpot](https://nuvia.ai/en/docs/colecoes/19431232-hubspot) 1. [How to set up the HubSpot integration](https://nuvia.ai/en/docs/artigos/14501908-how-to-set-up-the-hubspot-integration) 2. [How to sync contacts and deals between Nuvia and HubSpot](https://nuvia.ai/en/docs/artigos/14590403-how-to-sync-contacts-deals-nuvia-hubspot) 3. [What Nuvia syncs with HubSpot and when](https://nuvia.ai/en/docs/artigos/16473526-what-nuvia-syncs-with-hubspot-and-when) 4. [How to map fields between Nuvia and HubSpot](https://nuvia.ai/en/docs/artigos/16474177-how-to-map-fields-between-nuvia-and-hubspot) 5. [Troubleshooting the HubSpot integration](https://nuvia.ai/en/docs/artigos/16474434-troubleshooting-hubspot-integration) 6. [How to send Nuvia WhatsApp templates straight from a HubSpot workflow](https://nuvia.ai/en/docs/artigos/15879535-send-nuvia-whatsapp-templates-from-hubspot-workflow) 7. [How to enroll leads/contacts in Nuvia campaigns directly from a HubSpot workflow](https://nuvia.ai/en/docs/artigos/15879734-enroll-contacts-nuvia-campaigns-from-hubspot-workflow) On this page 1. Create a mapping 2. How fields are organized on screen 3. Labels that appear on the rows 4. Dropdowns and multiple choice 5. Refresh the property list 6. Frequently asked questions **On this page6 sections** 1. Create a mapping 2. How fields are organized on screen 3. Labels that appear on the rows 4. Dropdowns and multiple choice 5. Refresh the property list 6. Frequently asked questions Field mapping defines which information travels between the two systems. Nothing is synced by default; you create each field pair manually. **Available on:** Platform > Integrations > HubSpot > Fields **Who can do it:** Admin **Module:** Platform ## Create a mapping 1. In **Platform > Integrations > HubSpot**, find the account and click **Configure** 2. Open the **Fields** tab 3. Click **Add mapping** 4. In **HubSpot field**, choose the destination property — use **Search field…** to filter by name 5. In **Smart field**, choose the matching Nuvia field 6. Click **Save mappings** Note HubSpot custom properties are fully supported. Any **Contact**, **Deal**, or **Lead** property can be mapped. **Company** properties are not part of the mapping, because Nuvia does not write companies to HubSpot. ## How fields are organized on screen The list is split into two sides, each with its own organization. SideHow it is organized **HubSpot field** Grouped by object: **Contact**, **Deal**, and **Lead**. The most commonly used properties appear first; the rest follow in alphabetical order **Smart field** (Nuvia) Grouped by context: **Contact**, **Conversation**, **Qualification**, and **Company** To find a specific property in accounts with many fields, use the **Search field…** search inside the selector. It filters by name as you type. Note there is no limit on the number of mappings; you can keep dozens of rows with no impact on syncing. It is not currently possible to create your own groups or subfields to organize the list: the groups are fixed (by object on the HubSpot side, by context on the Nuvia side). In large accounts, search is the fastest way. ## Labels that appear on the rows - **Bidirectional sync (Contact, Deal, and Lead)** → the mapping applies in both directions. There is no per-field direction setting (direction can only be chosen in the **Funnels** tab, per stage) - **Read-only** → the property is calculated by HubSpot and cannot be written through the API Important you can save a mapping to a **read-only** property, but sending will fail every time. The error appears in the **History** with a message saying the property cannot be written to. Remove this mapping instead of leaving it active. ## Dropdowns and multiple choice When the Nuvia field is a **selection** or **multiple choice** field, Nuvia sends HubSpot **the option text**, exactly as it is set up in the Nuvia field. HubSpot only accepts this value if it is **identical** to one of the property's options, including uppercase, lowercase, accents, and spaces. Option in NuviaOption in HubSpotResult Hot Hot Syncs hot Hot **Rejected**, the capitalization difference invalidates the value Qualified Qualified with a trailing space **Rejected** Not interested Not Interested **Rejected** Critical when a selection value is rejected, HubSpot **rejects the entire record**, not just that field. All the other fields for that contact (or that deal, or that lead) in that send are not saved. The failure is recorded in the **History** tab, with status **Failed** or **Partial** and the message: “The value sent is not one of the options accepted by property X in HubSpot. Review this field's mapping in the integration.” Since the history is kept for 7 days, it is worth checking it regularly after changing selection fields. ### How to avoid it - Copy and paste the option text straight from HubSpot when you set up the field options in Nuvia; do not retype it - Standardize before mapping: if HubSpot has Hot, Warm, Cold, the Nuvia field needs to have exactly those three texts - After creating the mapping, change a test contact and check the result in the **History** ### Multiple choice Multiple choice values travel separated by semicolons (;), which is the separator HubSpot uses. So if **any** selected option has ; in its text, **the entire field is not sent**; the semicolon would break the value on the other side. The rest of the fields in that record go through normally. Avoid using ; in the option text of Nuvia selection fields. ### In the opposite direction When a dropdown value comes **from HubSpot**, it is saved in Nuvia with the option's **internal code**, not the label you see in HubSpot. In the History panel the label is displayed normally; the difference shows up in the value stored on the contact. ## Refresh the property list When someone creates, renames, or deletes a property in HubSpot: 1. Open the **Advanced** tab 2. In **Refresh fields**, click **Sync fields** Nuvia fetches the latest properties from HubSpot, makes the new ones available for mapping, and **removes mappings for properties that no longer exist**. Tip run **Sync fields** whenever the HubSpot team changes the property structure. It is the fastest way to get rid of orphaned mappings, which fail silently on every send. ## Frequently asked questions ## Frequently asked questions **Fields stopped going to HubSpot and no error appeared. What happened?** In most cases it is a selection field with a nonstandard value. HubSpot rejects the entire record when an option does not exactly match the property's options, even because of a capitalization or accent difference. Open the **History** tab, filter by **Failed**, and check the event message. **I have more than 40 mapped fields. Can I group them into subcategories?** Not currently. The groups are fixed: by object (Contact, Deal, Lead) on the HubSpot side and by context (Contact, Conversation, Qualification, Company) on the Nuvia side. There is no limit on the number of mappings, and the **Search field…** search inside the selector is the fastest way to find a specific property. **Can I map a field only to receive data, without sending it?** No. There is no per-field direction setting; the mapping applies in both directions. The exception is properties HubSpot marks as **Read-only**, which can only be read. Direction can only be chosen in the stage mapping, in the **Funnels** tab. **I created a new property in HubSpot and it does not show up in the list.** Go to **Advanced > Refresh fields** and click **Sync fields**. Nuvia reloads the HubSpot property list right away. **What happens if I delete a mapped property in HubSpot?** Sends to that property start failing. When you run **Sync fields**, Nuvia automatically removes the orphaned mapping. [PreviousWhat Nuvia syncs with HubSpot and when](https://nuvia.ai/en/docs/artigos/16473526-what-nuvia-syncs-with-hubspot-and-when) [NextTroubleshooting the HubSpot integration](https://nuvia.ai/en/docs/artigos/16474434-troubleshooting-hubspot-integration) Was this article helpful? ## Related articles - [How to set up the HubSpot integration](https://nuvia.ai/en/docs/artigos/14501908-how-to-set-up-the-hubspot-integration) - [How to sync contacts and deals between Nuvia and HubSpot](https://nuvia.ai/en/docs/artigos/14590403-how-to-sync-contacts-deals-nuvia-hubspot) - [How to create and edit Smart Funnels through MCP (Agent Builder)](https://nuvia.ai/en/docs/artigos/16074655-create-edit-smart-funnels-through-mcp-agent-builder) [HubSpot](https://nuvia.ai/en/docs/colecoes/19431232-hubspot) 1. [How to set up the HubSpot integration](https://nuvia.ai/en/docs/artigos/14501908-how-to-set-up-the-hubspot-integration) 2. [How to sync contacts and deals between Nuvia and HubSpot](https://nuvia.ai/en/docs/artigos/14590403-how-to-sync-contacts-deals-nuvia-hubspot) 3. [What Nuvia syncs with HubSpot and when](https://nuvia.ai/en/docs/artigos/16473526-what-nuvia-syncs-with-hubspot-and-when) 4. [How to map fields between Nuvia and HubSpot](https://nuvia.ai/en/docs/artigos/16474177-how-to-map-fields-between-nuvia-and-hubspot) 5. [Troubleshooting the HubSpot integration](https://nuvia.ai/en/docs/artigos/16474434-troubleshooting-hubspot-integration) 6. [How to send Nuvia WhatsApp templates straight from a HubSpot workflow](https://nuvia.ai/en/docs/artigos/15879535-send-nuvia-whatsapp-templates-from-hubspot-workflow) 7. [How to enroll leads/contacts in Nuvia campaigns directly from a HubSpot workflow](https://nuvia.ai/en/docs/artigos/15879734-enroll-contacts-nuvia-campaigns-from-hubspot-workflow) ## Still need help? Customers reach support through the chat inside the platform. Not a customer yet? Talk to our team. [Talk to support in the platform](https://app.nuvia.ai) [I'm not a customer yet](https://nuvia.ai/en/contact) --- Source: https://nuvia.ai/en/docs/artigos/16474177-how-to-map-fields-between-nuvia-and-hubspot