All about HubSpot
HubSpot connection and integration settings
Settings that apply to HubSpot as a whole, such as default values for currency, VAT and language, and updating existing companies and contacts.
Updated November 9, 2026
These settings apply to HubSpot as a whole, not to one flow. They hold default values that several flows use. You find them in your integration under Settings.
What these settings are about
- Default currency and VAT rates, for example for prices, shipping costs, payment costs, billing costs and commission.
- The default language, which decides in which language APIcenter fills in a country name.
- Whether APIcenter updates existing companies and contacts in HubSpot, including the name of a contact and the company name on a contact.
- Settings for country code, language with region and stock. These have no effect for HubSpot, and the explanation says so.
When you change them
- When you set up the integration for the first time.
- When you need other default values, such as another currency or another VAT rate.
- When you do or do not want APIcenter to overwrite companies and contacts that you maintain in HubSpot.
Settings for one flow, such as the pipeline and deal stage for orders, are on the Settings tab of that flow. The article of each flow explains them, for example Send sales orders to HubSpot.
To learn how to connect HubSpot, read Connect HubSpot to APIcenter.
Below you find the connection and integration settings for HubSpot, each with its own explanation.
Settings
The settings you see in the dashboard, with what each one does.
API Password
AuthenticationAPI Username
AuthenticationAPI url
AuthenticationDefault currency billing costs
CurrenciesDefault currency commission
CurrenciesDefault currency payment costs
CurrenciesDefault currency prices
CurrenciesThe currency that APIcenter assumes for prices and amounts of products, orders and order lines if the data does not contain one. Use the ISO code, for example EUR or USD. Default: EUR. When getting deals, APIcenter uses the currency of the deal in HubSpot (deal_currency_code); this setting is then only a fallback. The default data mapping to HubSpot does not send a currency, so this setting does not decide which currency a deal or product gets in HubSpot.
Default currency shipping costs
CurrenciesUpdate existing companies
Customer SettingsDecides if APIcenter updates a company that already exists in HubSpot when a customer or order arrives for it. APIcenter recognizes an existing company by the ID, the e-mail address of the company, the name or the domain. If this is on (default for HubSpot), the data of the company is overwritten with the incoming data. If this is off, the existing company stays as it is and the rest of the flow, such as the contacts and the order, continues as normal.
Update existing contacts
Customer SettingsDecides if APIcenter updates a contact that already exists in HubSpot when a customer or order arrives for it. APIcenter recognizes an existing contact by the ID or the e-mail address. If this is on (default for HubSpot), the data of the contact is overwritten with the incoming data. If this is off, the existing contact stays as it is.
Update name of existing companies
Customer SettingsThis setting has no effect for HubSpot. When updating a company, APIcenter always updates the name too, as long as Update existing companies is on. If that setting is off, the company is not updated and the name also stays the same. You can leave this setting as it is.
Update name of existing contacts
Customer SettingsDecides if APIcenter updates the first name and last name of an existing contact in HubSpot. This only works if Update existing contacts is on. If this is off, the first name and last name of the contact stay the same and the other data is updated. For HubSpot, this is on by default.
Update relation to company of existing contacts
Customer SettingsDecides what APIcenter does with the company name on an existing contact when you update contacts. If this is on (default), the company name from the incoming data applies. If this is off and the data does not contain a company name, the contact keeps the company name that is already in HubSpot. This only works if Update existing contacts is on.
Default country code
General Integration settingThis setting has no effect for HubSpot. None of the HubSpot flows uses a default country code, so you can leave it as it is. Options: BE, DE, ES, FR, NL and UK. Default: NL.
Default language (local) to use
General Integration settingThis setting has no effect for HubSpot. APIcenter does not use a default language with region (locale) in any of the HubSpot flows, so you can leave it as it is. You write a locale as language_COUNTRY, for example nl_NL. Default: nl_NL.
Default language to use
General Integration settingThe language that APIcenter uses if the data does not contain a language. The default data mapping to HubSpot does not send a language. The setting does decide in which language APIcenter fills in the country name if the data only contains a country code or a name in another language; the default data mapping puts this country name in the field country of the company or contact. Options: DA (Danish), DE (German), GB (English), ES (Spanish), FR (French), IT (Italian), NL (Dutch), PL (Polish), PT (Portuguese), SV (Swedish) and TR (Turkish). Default: NL.
Use stock value
Stock & Warehouse SettingsThis setting has no effect for HubSpot. None of the HubSpot flows uses stock, so you can leave it as it is. Options: Actual, Economic, Stock minus reservations and Available. Default: Available.
Default tax rate billing costs
Tax & Tax RatesDefault tax rate commission
Tax & Tax RatesDefault tax rate payment costs
Tax & Tax RatesDefault tax rate prices
Tax & Tax RatesThe VAT rate in percent that APIcenter uses for prices and amounts of products, orders and order lines if the rate is not in the data. APIcenter uses it to convert amounts with and without VAT into each other, for example for the VAT amount (tax) on an order line or product that goes to HubSpot. Enter a number without the % sign. Default: 21.