All about HubSpot
HubSpot: Send products to HubSpot
Send products from your webshop or PIM to HubSpot, with SKU, name, description, price and, if you set it up, variants and features.
Updated November 9, 2026
This flow sends products from another application, such as a webshop or a PIM, to HubSpot. APIcenter creates and updates products.
How it works
- APIcenter searches for the product in HubSpot by the SKU (
hs_sku). If it does not exist, APIcenter creates it. - If the product already exists, APIcenter only updates it if Update existing products is on. If it is off (default), the flow reports that the product may not be updated.
- For an update, you decide with Update product name and Update product description if the name and the description are overwritten.
- By default, APIcenter sends the SKU, the name, the description, the price and the VAT amount. You add more fields under Data mapping.
- APIcenter does not send images to HubSpot.
- APIcenter processes variants if you set the product property for the main product. The variant gets the SKU of the main product in this property. If you leave the property empty, APIcenter processes the product as a separate product.
- APIcenter writes features and attributes to properties in the groups that you set: the group for features and the group for attributes. If you do not set a group, APIcenter does not process those features or attributes.
- If a property or option does not exist in HubSpot, the flow stops with an error message, unless Create missing properties in the target system is on. Then APIcenter creates the property or option.
What you need first
- HubSpot is connected to APIcenter. See Connect HubSpot to APIcenter.
- The product has a SKU. APIcenter recognizes the product by it.
- For variants: a product property in HubSpot for the SKU of the main product.
- For features and attributes: property groups in HubSpot with the related properties. You can only add an option to a property that HubSpot has not locked.
Tips
- Do you not see changes on an existing product? Check if Update existing products is on.
- Do you not see images in HubSpot? This is correct: APIcenter does not send them.
- According to HubSpot, it can take a moment before new records appear in search results. If you send the same product twice in a short time, APIcenter may not find the first one yet.
Below you find all settings of this flow, each with its own explanation.
Settings
The settings you see in the dashboard, with what each one does.
Default attribute set
Attributes & FeaturesThis setting has no effect in the default data mapping to HubSpot. APIcenter writes attributes to the property group that you set in Property category name to use for attributes, and not to an attribute set. The value is only used if you link the attribute set yourself to a HubSpot property in the Data mapping.
Default feature set
Attributes & FeaturesThis setting has no effect in the default data mapping to HubSpot. APIcenter writes features to the property group that you set in Property category name to use for features, and not to a feature set. The value is only used if you link the feature set yourself to a HubSpot property in the Data mapping.
Force the usage of the default attribute set id
Attributes & FeaturesThis setting has no effect in the default data mapping to HubSpot, because the default data mapping does not send an attribute set, so there is nothing to force. It only matters if you link the attribute set yourself to a HubSpot property in the Data mapping. Leave it off (default).
Force the usage of the default feature set id
Attributes & FeaturesThis setting has no effect in the default data mapping to HubSpot, because the default data mapping does not send a feature set, so there is nothing to force. It only matters if you link the feature set yourself to a HubSpot property in the Data mapping. Leave it off (default).
Make use of a default feature set id
Attributes & FeaturesThis setting has no effect in the default data mapping to HubSpot. The default data mapping to HubSpot does not send a feature set. You only need it if you link the feature set yourself to a HubSpot property in the Data mapping of the flow. Leave it off (default): if it is on without a value, the flow stops with an error message.
Use attribute mapping table
Attributes & FeaturesUse a mapping table to link the names and values of attributes from the other application to the names and options of HubSpot properties. APIcenter searches for the property in the group that you set in Property category name to use for attributes, by name or label. Values that are not in the table are handled according to What to do with a value that cannot be mapped using the mapping table. Default: off.
Use attribute set mapping
Attributes & FeaturesThis setting has no effect in the default data mapping to HubSpot. The default data mapping does not send an attribute set, so there is nothing to map. You only need the mapping table if you link the attribute set yourself to a HubSpot property in the Data mapping. Leave it off (default).
Use feature mapping
Attributes & FeaturesUse a mapping table to link the names and values of features from the other application to the names and options of HubSpot properties. APIcenter searches for the property in the group that you set in Property category name to use for features, by name or label. Values that are not in the table are handled according to What to do with a value that cannot be mapped using the mapping table. Default: off.
Use feature set mapping
Attributes & FeaturesThis setting has no effect in the default data mapping to HubSpot. The default data mapping does not send a feature set, so there is nothing to map. You only need the mapping table if you link the feature set yourself to a HubSpot property in the Data mapping. Leave it off (default).
What to do with a value that cannot be mapped using the mapping table
Attributes & FeaturesWhat to do with a value that cannot be mapped using the mapping table
Attributes & FeaturesWhat to do with a value that cannot be mapped using the mapping table
Attributes & FeaturesThis setting has no effect in the default data mapping to HubSpot. The default data mapping does not send an attribute set. It only decides what happens if you use the mapping table for attribute sets yourself: Use default (default) uses the default value, Use value passes on the original value and Ignore value leaves the field empty.
What to do with a value that cannot be mapped using the mapping table
Attributes & FeaturesThis setting has no effect in the default data mapping to HubSpot. The default data mapping does not send a feature set. It only decides what happens if you use the mapping table for feature sets yourself: Use default (default) uses the default value, Use value passes on the original value and Ignore value leaves the field empty.
Default category name
CategoriesThis setting has no effect in the default data mapping to HubSpot. The default data mapping does not send a category. The value is only used if Enable use of default category is on and you link the category yourself to a HubSpot property in the Data mapping. Leave the field empty.
Enable use of default category
CategoriesThis setting has no effect in the default data mapping to HubSpot. The HubSpot flows do not process product categories and the default data mapping does not send a category. You only need it if you link the category yourself to a HubSpot property in the Data mapping. Leave it off (default): if it is on without a value, the flow stops with an error message.
Force category on variant as parent
CategoriesThis setting has no effect for HubSpot. The HubSpot flows do not process product categories, so there is nothing to take over from the main product. Leave it off (default).
Force use of default category
CategoriesThis setting has no effect in the default data mapping to HubSpot, because the default data mapping does not send a category, so there is nothing to force. It only matters if you link the category yourself to a HubSpot property in the Data mapping. Leave it off (default).
Set category on variant as parent
CategoriesThis setting has no effect for HubSpot. The HubSpot flows do not process product categories, so there is nothing to take over from the main product. Leave it off (default).
Use Category mapping
CategoriesThis setting has no effect in the default data mapping to HubSpot. The default data mapping does not send a category, so there is nothing to map. You only need the mapping table if you link the category yourself to a HubSpot property in the Data mapping. Leave it off (default).
This setting has no effect in the default data mapping to HubSpot. The default data mapping does not send a category. It only decides what happens if you use the mapping table for categories yourself: Use default (default) uses the default value, Use value passes on the original value and Ignore value leaves the field empty.
Default price list group
Customer SettingsThis setting has no effect in the default data mapping to HubSpot. The default data mapping does not send a price list group. The value is only used if Enable use of a default customer price list group is on and you link the price list group yourself to a HubSpot property in the Data mapping. Leave the field empty.
Enable use of a default customer price list group
Customer SettingsThis setting has no effect in the default data mapping to HubSpot. The default data mapping to HubSpot does not send a price list group. You only need it if you link the price list group yourself to a HubSpot property in the Data mapping of the flow. Leave it off (default): if it is on without a value, the flow stops with an error message.
Force the usage of the default price list group
Customer SettingsThis setting has no effect in the default data mapping to HubSpot, because the default data mapping does not send a price list group, so there is nothing to force. It only matters if you link the price list group yourself to a HubSpot property in the Data mapping. Leave it off (default).
Use default price list group mapping table
Customer SettingsThis setting has no effect in the default data mapping to HubSpot. The default data mapping does not send a price list group, so there is nothing to map. You only need the mapping table if you link the price list group yourself to a HubSpot property in the Data mapping. Leave it off (default).
What to do with a value that cannot be mapped using the mapping table
Customer SettingsThis setting has no effect in the default data mapping to HubSpot. The default data mapping does not send a price list group. It only decides what happens if you use the mapping table for price list groups yourself: Use default (default) uses the default value, Use value passes on the original value and Ignore value leaves the field empty.
Enable URL Encoding of data in the endpoints of the source application
General flow settingEnable URL Encoding of data in the endpoints of the target application
General flow settingEnable URL encoding of data in endpoints
General flow settingTurns on URL encoding for values that APIcenter puts in the URL of a request to HubSpot. This prevents errors with special characters such as spaces, slashes or ampersands. In HubSpot, search values such as an e-mail address, SKU or deal name are in the content of the request and not in the URL; the URL only contains IDs and object types. So you rarely need this. This is the main switch: values are only encoded if you also turn on Enable URL Encoding of data in the endpoints of the source application (when getting) or Enable URL Encoding of data in the endpoints of the target application (when sending). Default: off.
Use administration mapping table
General flow settingThis setting has no effect for HubSpot. The data that APIcenter exchanges with HubSpot has no administration field, so there is nothing to map. Leave this setting off (default).
What to do with a value that cannot be mapped using the mapping table
General flow settingThis setting has no effect for HubSpot, because the data that APIcenter exchanges with HubSpot has no administration field. Leave it as it is.
Enrichement level to use as default
Marketplace SettingsThis setting has no effect for HubSpot. APIcenter does not use it in the HubSpot flows, so you can leave it as it is.
Notifications Email address
NotificationsNotifications Slack webhook
NotificationsNotifications frequency
NotificationsReceive Notifications
NotificationsCreate missing properties in the target system
Product SettingsDecides if APIcenter creates a property or an option that does not exist in HubSpot. If this is off (default), the flow stops with an error message when a property or option is missing. If this is on, APIcenter creates the property or option in the group that you set. You can only add an option to a property that HubSpot has not locked; otherwise an error message follows.
Only update existing variants and don't create new ones
Product SettingsThis setting has no effect. APIcenter does not use it in the HubSpot flows: a variant that does not exist yet is always created. You can leave it as it is. Default: off.
Property category name to use for attributes
Product SettingsThe name of the property group in HubSpot that holds the properties for attributes, such as color or size, in which variants differ. For Get Product, APIcenter reads each property in this group as an attribute, with the label of the chosen option as value; this only works if you also set the property for the main product. For Send Product, APIcenter writes the attributes to properties in this group. If you leave this field empty, APIcenter does not process attributes.
Property category name to use for features
Product SettingsThe name of the property group in HubSpot that holds the properties for features of a product. For Get Product, APIcenter reads each property in this group as a feature, with the label of the chosen option as value; this only works if you also set the property for the main product. For Send Product, APIcenter writes the features to properties in this group. If you leave this field empty, APIcenter does not process features.
Property name or id of the property that holds the parent reference.
Product SettingsThe name or label of the product property in HubSpot that holds the SKU of the main product. For Get Product, APIcenter treats a product with a value in this property as a variant of the product with that SKU. For Send Product, a variant gets the SKU of the main product in this property. If the property does not exist, the flow stops with an error message, unless Create missing properties in the target system is on. If you leave this field empty, APIcenter processes all products as separate products, without variants.
Skip negativity flip process
Product SettingsUpdate existing products
Product SettingsDecides what happens if a product with the same SKU (hs_sku) already exists in HubSpot. If this is off (default), APIcenter does not update the product and the flow reports that the product may not be updated. If this is on, APIcenter updates the existing product. With Update product name, Update product description and Update product images, you decide which fields are overwritten.
Update product description
Product SettingsUpdate product images
Product SettingsThis setting has no effect for HubSpot. For Send Product, APIcenter does not send images to HubSpot, even if the data mapping contains images. You can leave it as it is.
Update product name
Product SettingsMaximum number of pages to retrieve
Run behaviourIn practice, this setting has no effect for HubSpot. The HubSpot flows ask for one list per run with their own limit (when getting data, this is Amount to process) and do not read extra pages. The default value is 20; you do not need to change it.
Use page size
Run behaviourIn practice, this setting has no effect for HubSpot. The HubSpot flows decide themselves how many records they ask for per request: when getting data, this is Amount to process. The default value is 50; you do not need to change it.
Enable the use of a default warehouse
Stock & Warehouse SettingsThis setting has no effect in the default data mapping to HubSpot. The HubSpot flows do not use a warehouse and the default data mapping does not send one. You only need it if you link the warehouse yourself to a HubSpot property in the Data mapping of the flow. Leave it off (default): if it is on without a value, the flow stops with an error message.
Force the usage of the default warehouse
Stock & Warehouse SettingsThis setting has no effect in the default data mapping to HubSpot, because the default data mapping does not send a warehouse, so there is nothing to force. It only matters if you link the warehouse yourself to a HubSpot property in the Data mapping. Leave it off (default).
Use warehouse mapping table
Stock & Warehouse SettingsThis setting has no effect in the default data mapping to HubSpot. The default data mapping does not send a warehouse, so there is nothing to map. You only need the mapping table if you link the warehouse yourself to a HubSpot property in the Data mapping. Leave it off (default).
Value for the default warehouse id
Stock & Warehouse SettingsThis setting has no effect in the default data mapping to HubSpot. The default data mapping does not send a warehouse. The value is only used if Enable the use of a default warehouse is on and you link the warehouse yourself to a HubSpot property in the Data mapping. Leave the field empty.
What to do with a value that cannot be mapped using the mapping table
Stock & Warehouse SettingsThis setting has no effect in the default data mapping to HubSpot. The HubSpot flows do not use a warehouse. It only decides what happens if you use the mapping table for warehouses yourself: Use default (default) uses the default value, Use value passes on the original value and Ignore value leaves the field empty.
Enable the use of a default tax id
Tax & Tax RatesThis setting has no effect in the default data mapping to HubSpot. The default data mapping to HubSpot sends the VAT amount (tax) and no VAT code or tax class. The VAT amount is calculated from the amounts in the data or, if the rate is not in them, from Default tax rate prices. Leave this setting off (default): if it is on without a value for Value for the default tax id (exclude '%'), the flow stops with an error message.
Force the use of the default tax id
Tax & Tax RatesThis setting has no effect in the default data mapping to HubSpot. The default data mapping to HubSpot sends the VAT amount (tax) and no VAT code or tax class. Leave this setting off (default).
Use default tax id mapping table
Tax & Tax RatesThis setting has no effect in the default data mapping to HubSpot, so there is nothing to map. The default data mapping to HubSpot sends the VAT amount (tax) and no VAT code or tax class. You only need the mapping table if you link a tax class yourself to a HubSpot property in the Data mapping. Leave it off (default).
Value for the default tax id (exclude '%')
Tax & Tax RatesThis setting has no effect in the default data mapping to HubSpot. The default data mapping to HubSpot sends the VAT amount (tax) and no VAT code or tax class. You only need this field if you link a tax class yourself to a HubSpot property in the Data mapping. Leave the field empty.
This setting has no effect in the default data mapping to HubSpot. The default data mapping to HubSpot sends the VAT amount (tax) and no VAT code or tax class. It only decides what happens if you use the mapping table for tax classes yourself: Use default (default) uses the default value, Use value passes on the original value and Ignore value leaves the field empty.