HubSpot Multicurrency

Name: HubSpot Multicurrency API
Brand: HubSpot Multicurrency
Availability: InStock

✓ Official Vendor SpecFinanceAccountingoauth2,apiKey12 EndpointsREST

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.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic 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

GET STARTED

Start building with HubSpot Multicurrency API

Explore with Jentic

View OpenAPI Document

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.

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

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

HubSpot OAuth and private-app tokens sit encrypted in the Jentic MAXsystem vault. Agents call Multicurrency operations through scoped execution handles — raw Bearer tokens never enter the prompt context.

Intent-based discovery

Agents search by intent like 'update HubSpot exchange rate' or 'list HubSpot currencies' and Jentic returns the matching operation with its input schema, including required fields like fromCurrencyCode and effectiveAt.

Time to first call

Direct integration: 1-2 days for OAuth, schema mapping, and batch retry logic. Through Jentic: under 30 minutes — search, load, execute the batch operation.

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 the encrypted MAXsystem vault 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.

HubSpot Multicurrency

Connect the HubSpot Multicurrency to your agent

Capabilities

Start building with HubSpot Multicurrency API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs