HubSpot Taxes

Name: Taxes API
Brand: Taxes
Availability: InStock

✓ Official Vendor SpecCRMDeal Pipelineoauth2,apiKey11 EndpointsREST

Install Jentic One Beta

Connect the Taxes to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Taxes, 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 Taxes API.

Create a new tax rate via POST /crm/v3/objects/taxes

Update a tax rate or label using PATCH /crm/v3/objects/taxes/{taxId}

List all configured tax rates with GET /crm/v3/objects/taxes

Search taxes by label or rate via POST /crm/v3/objects/taxes/search

GET STARTED

Start building with Taxes API

Explore with Jentic

View OpenAPI Document

For Agents

Create, read, update, and search HubSpot CRM Tax records — the tax rates HubSpot Commerce applies to quote and invoice line items — through /crm/v3/objects/taxes.

Use for: I need to create a new VAT rate of 20% for UK orders, Update the rate on an existing tax record, List all tax rates configured in the HubSpot portal, Search for tax records that match a specific label

Not supported: Does not calculate tax, file returns, or determine nexus — use for managing named tax rate records inside HubSpot CRM only.

Use Cases

Patterns agents use Taxes API for, with concrete tasks.

★ Loading Tax Rates From an External Tax Service

Companies that calculate tax in an external service (Avalara, TaxJar, Stripe Tax) often need the resulting named rates to exist in HubSpot so they appear correctly on quotes and invoices. A scheduled job pulls the latest rates and uses POST /crm/v3/objects/taxes/batch/upsert keyed by an external_tax_code custom property. New rates are created, existing ones updated, and obsolete ones archived in a follow-up call.

Call POST /crm/v3/objects/taxes/batch/upsert with idProperty='external_tax_code' and inputs containing label, rate, and jurisdiction for each tax rate from the external service.

Per-Jurisdiction Tax Configuration

B2B businesses selling across regions need tax records for each jurisdiction (VAT for the UK and EU member states, GST for Canada, state sales tax for the US). Using POST /crm/v3/objects/taxes/batch/create the configuration runs once during setup, creating dozens of rates in seconds. Quotes and invoices generated against the right jurisdiction line items then pick up the correct tax rate automatically.

Call POST /crm/v3/objects/taxes/batch/create with one input per jurisdiction (label='UK VAT 20%', rate=20, etc.).

Tax Rate Audit and Cleanup

Finance teams periodically audit tax records to remove rates that are no longer used or have been superseded by new legislation. POST /crm/v3/objects/taxes/search returns all records (paged), the team flags obsolete entries, and POST /crm/v3/objects/taxes/batch/archive removes them in one call. Updates to active rates are applied via POST /crm/v3/objects/taxes/batch/update.

Call POST /crm/v3/objects/taxes/search to list all tax records, identify those with obsolete labels, then POST /crm/v3/objects/taxes/batch/archive with their IDs.

AI Agent Tax Lookup During Quote Generation

An AI quoting agent generates a HubSpot quote and needs to attach the right tax rate to each line item based on jurisdiction. Through Jentic the agent searches for tax operations, queries existing tax records by jurisdiction label, and uses the returned taxId on line item creation. Jentic stores OAuth credentials in its vault so the agent only handles scoped execution tokens.

Search Jentic for 'find hubspot tax rate by jurisdiction', load the search operation, and execute POST /crm/v3/objects/taxes/search filtered by label='UK VAT 20%'.

Key Endpoints

11 endpoints — the hubspot crm taxes api manages tax records — the named tax rates that hubspot commerce applies to line items on quotes, invoices, and subscriptions.

METHOD

PATH

DESCRIPTION

POST

/crm/v3/objects/taxes

Create a tax rate

GET

/crm/v3/objects/taxes/{taxId}

Read a tax rate

PATCH

/crm/v3/objects/taxes/{taxId}

Update a tax rate

DELETE

/crm/v3/objects/taxes/{taxId}

Archive a tax rate

POST

/crm/v3/objects/taxes/search

Search tax rates

POST

/crm/v3/objects/taxes/batch/upsert

Upsert tax rates by external key

POST

/crm/v3/objects/taxes/batch/create

Batch create tax rates

POST

/crm/v3/objects/taxes

Create a tax rate

GET

/crm/v3/objects/taxes/{taxId}

Read a tax rate

PATCH

/crm/v3/objects/taxes/{taxId}

Update a tax rate

DELETE

/crm/v3/objects/taxes/{taxId}

Archive a tax rate

POST

/crm/v3/objects/taxes/search

Search tax rates

Why Jentic?

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

Credential isolation

HubSpot OAuth tokens and private app keys are stored encrypted in the Jentic vault. Agents receive scoped execution tokens — the raw secret never enters agent context or logs.

Intent-based discovery

Agents search Jentic with intents like 'create hubspot tax rate' and Jentic returns the matching Taxes operations with typed input schemas, so the agent can configure rates without browsing HubSpot's docs.

Time to first call

Direct HubSpot Taxes integration with OAuth and external sync logic: 1-2 days. Through Jentic: under 30 minutes — search, load schema, execute.

FAQs

Specific to using Taxes API through Jentic.

What authentication does the HubSpot Taxes API use?

It supports OAuth 2.0 (recommended for public apps) and HubSpot private app access tokens passed as a Bearer token in the Authorization header. Through Jentic the token is stored encrypted in the vault and injected at execution time so the agent never holds the raw secret.

Can I associate a tax record with line items through this API?

Yes. The Taxes API exposes the standard CRM associations pattern, so you can pass association inputs when creating or updating a tax record, or use the Associations API to link existing tax records to line items after the fact.

What are the rate limits for the HubSpot Taxes API?

HubSpot enforces 100 requests per 10 seconds for OAuth apps and 190 per 10 seconds for private apps on Enterprise tiers, plus daily quotas. Use POST /crm/v3/objects/taxes/batch/create and batch/upsert (up to 100 records per request) when loading many rates at once.

How do I keep HubSpot tax rates in sync with Avalara through Jentic?

Search Jentic for 'upsert hubspot tax rates', load POST /crm/v3/objects/taxes/batch/upsert, and execute it with idProperty set to your external_tax_code property and inputs containing the latest rates from Avalara. Jentic returns typed responses for each upserted record.

Does the Taxes API calculate tax for an order?

No. This API only manages named tax rate records. Actual tax calculation happens inside HubSpot Commerce when those rates are applied to line items, or in an external tax service whose results you sync into HubSpot via this API.

Can I archive a tax rate that is still attached to historical line items?

Yes — archiving a tax record with DELETE /crm/v3/objects/taxes/{taxId} removes it from active selection but leaves historical line item associations intact. To remove permanently you must use HubSpot's GDPR delete process.

HubSpot Taxes

Connect the Taxes to your agent

Capabilities

Start building with Taxes API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs