HubSpot Multicurrency
Browse all Hubspot APIsOfficial vendor OpenAPI document · agent-readyFinanceAccountingoauth2,apiKey12 EndpointsREST
For Agents
Read and update the HubSpot company currency, supported currency list, and the exchange rates used to convert deal amounts in reporting.
Use for: I need to set the home currency for this HubSpot portal, List the active exchange rates HubSpot is using for deal conversion, Update the EUR-to-USD exchange rate for tomorrow, Batch upload month-end exchange rates from the accounting system
Not supported: Does not process payments, file taxes, or post journal entries - use for HubSpot home currency configuration and exchange rate management only.
The HubSpot Multicurrency API manages the currency configuration that every deal, quote, and revenue report on a HubSpot portal depends on. It exposes the company's home currency, the supported ISO currency code list, and the active and historical exchange rates used to convert deal amounts back to the home currency. Rates can be created, batch updated, hidden from the UI, and queried by ID so finance teams can keep HubSpot's reporting aligned with their accounting source of truth.
Install Jentic One Beta
Connect the HubSpot Multicurrency to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the HubSpot Multicurrency, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fhubspot.com%2Fhubspot-multicurrency" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fhubspot.com%2Fhubspot-multicurrency" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with HubSpot Multicurrency API.
Get the home currency configured for the HubSpot account
Update the company home currency that all reports normalise to
List the supported ISO currency codes that can be enabled on the portal
List current and historical exchange rates against the home currency
Create a new exchange rate entry between two currencies
Batch create or batch update multiple exchange rates in a single call
Hide outdated exchange rates from the HubSpot reporting UI without deleting them
Use Cases
Patterns agents use HubSpot Multicurrency API for, with concrete tasks.
★ Month-end exchange rate sync from accounting
Pull the official month-end exchange rates from the company's ERP or accounting system and push them into HubSpot in a single batch so deal pipeline reports normalise to the home currency using the same rates finance closed the books with. The batch create endpoint handles dozens of currency pairs in one call rather than per-pair updates.
Read month-end rates from the ERP, then POST /settings/v3/currencies/exchange-rates/batch/create with an array of {fromCurrencyCode, toCurrencyCode, exchangeRate, effectiveAt} objects.
Auditing the home currency configuration
Verify that a HubSpot portal's home currency and enabled currency list match the legal entity setup before pushing deals from a CRM migration. The API returns the company-currency record and the full supported ISO code list so the migration script can fail fast if a currency the source system uses is not yet enabled.
Call GET /settings/v3/currencies/company-currency and GET /settings/v3/currencies/codes, then verify each currency present on incoming deals exists in the codes list.
Cleaning up stale FX rates
Hide outdated exchange rates from HubSpot's reporting UI without losing them from the historical record. The visibility update endpoint flips rates between visible and hidden so reps see only current rates in the UI while finance retains the full audit trail tied by exchange rate ID.
Call POST /settings/v3/currencies/exchange-rates/update-visibility with the IDs of last quarter's rates and visibility=false to remove them from the reporting UI.
Agent-driven currency operations through Jentic
An AI agent that reconciles cross-region pipeline reports searches Jentic for the HubSpot exchange rate operations, loads their schemas, and pushes corrected rates without ever holding a HubSpot OAuth token in its context. Jentic's credential vault means the same agent can run against multiple HubSpot portals safely.
Through Jentic, search 'update HubSpot exchange rate', load the schema for POST /settings/v3/currencies/exchange-rates, and execute it with the corrected USD-to-EUR rate.
Key Endpoints
12 endpoints — the hubspot multicurrency api manages the currency configuration that every deal, quote, and revenue report on a hubspot portal depends on.
METHOD
PATH
DESCRIPTION
GET
/settings/v3/currencies/company-currency
Get the configured home currency for the portal
PUT
/settings/v3/currencies/company-currency
Update the portal home currency
GET
/settings/v3/currencies/codes
List the supported ISO currency codes
GET
/settings/v3/currencies/exchange-rates
List historical and current exchange rates
POST
/settings/v3/currencies/exchange-rates
Create a new exchange rate entry
POST
/settings/v3/currencies/exchange-rates/batch/create
Batch create exchange rates
POST
/settings/v3/currencies/exchange-rates/batch/update
Batch update existing exchange rates
POST
/settings/v3/currencies/exchange-rates/update-visibility
Hide or show exchange rates in the reporting UI
GET
/settings/v3/currencies/company-currency
Get the configured home currency for the portal
PUT
/settings/v3/currencies/company-currency
Update the portal home currency
GET
/settings/v3/currencies/codes
List the supported ISO currency codes
GET
/settings/v3/currencies/exchange-rates
List historical and current exchange rates
POST
/settings/v3/currencies/exchange-rates
Create a new exchange rate entry
POST
/settings/v3/currencies/exchange-rates/batch/create
Batch create exchange rates
POST
/settings/v3/currencies/exchange-rates/batch/update
Batch update existing exchange rates
POST
/settings/v3/currencies/exchange-rates/update-visibility
Hide or show exchange rates in the reporting UI
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring HubSpot Multicurrency by hand means running its OAuth flow or minting a private-app token, targeting api.hubapi.com, and batching exchange-rate updates against currency codes yourself. Through Jentic you install once, import HubSpot Multicurrency from the API Directory, store the credential once, and your agent calls it.
Permission scoping
This API addresses currencies and exchange rates through fixed settings paths and request-body fields like fromCurrencyCode, so limit the agent to the operations it needs, such as reading currency codes or listing exchange rates. You choose the operations it may call, so setting the company currency or a batch rate update is not included unless you add it.
Credential isolation
Your HubSpot OAuth or private-app token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'update a HubSpot exchange rate' or 'list HubSpot currencies', and Jentic returns the matching operation with its input schema, including required fields like fromCurrencyCode and effectiveAt, so the agent calls the right endpoint without browsing the HubSpot reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
Alternative
Stripe
Payment platform that maintains its own settlement currency and FX rates separate from HubSpot
Choose Stripe's reporting when the source of truth for FX is the actual settlement currency rather than HubSpot pipeline reporting.
FAQs
Specific to using HubSpot Multicurrency API through Jentic.
What authentication does the HubSpot Multicurrency API use?
It accepts HubSpot OAuth 2.0 tokens and private-app tokens passed as a Bearer header. Through Jentic the token sits in your encrypted Jentic One instance and is injected at execution time so it stays out of the agent's context.
Can I batch update exchange rates for many currency pairs at once?
Yes. POST /settings/v3/currencies/exchange-rates/batch/update accepts an array of rate updates in a single call, which is the right endpoint to use for a month-end FX sync from an ERP.
What are the rate limits for the HubSpot Multicurrency API?
HubSpot's standard public API limits apply: 100 requests per 10 seconds for OAuth apps and 110 per 10 seconds for private apps. Use the batch endpoints to avoid burning request budget on per-pair updates.
How do I change the home currency through Jentic?
Search Jentic for 'update HubSpot home currency', load the schema for PUT /settings/v3/currencies/company-currency, and execute it with the new ISO currency code. All deal reporting recalculates against the new home currency.
Does deleting an exchange rate change historical reports?
Use the visibility endpoint POST /settings/v3/currencies/exchange-rates/update-visibility instead of deletion. Hiding a rate removes it from the UI but preserves the historical conversion record so closed-period reports stay consistent.
Which currencies can I enable on a HubSpot portal?
Call GET /settings/v3/currencies/codes to retrieve the full list of ISO currency codes HubSpot supports for the portal before attempting to add a new exchange rate against an unsupported code.
Can I limit what my agent is allowed to do with the HubSpot Multicurrency API?
Yes. Because you run Jentic One yourself, your own rules decide which HubSpot Multicurrency operations and credentials the agent may use. You can allow read-only calls such as GET /settings/v3/currencies/codes and GET /settings/v3/currencies/exchange-rates while withholding write operations like PUT /settings/v3/currencies/company-currency or the batch rate updates. Those higher-impact operations are not available to the agent unless you explicitly add them.
GET STARTED