HubSpot Fees
Browse all Hubspot APIsOfficial vendor OpenAPI document · agent-readyCRMDeal Pipelineoauth2, apiKey11 EndpointsREST
For Agents
Create, update, search, and batch-manage HubSpot fee records used on quotes and line items via /crm/v3/objects/fees.
Use for: I need to create a $25 shipping fee that can be added to quotes, Update a processing fee amount when payment provider rates change, Search for all active fees over $50, Bulk-import a regional fee catalogue from a pricing spreadsheet
Not supported: Does not calculate quote totals, run pricing approval workflows, or process payment - use for managing reusable fee records inside HubSpot CRM only.
The HubSpot Fees API manages fee records used on quotes and line items, exposing single and batch CRUD plus search across /crm/v3/objects/fees. Fees represent shipping, handling, processing, or service charges that are added to a customer-facing quote alongside the product line items. Agents use this API to maintain a reusable fee catalogue, attach fees to quotes, and reconcile billed fees in commission or revenue reporting.
Install Jentic One Beta
Connect the Fees to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Fees, 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-crm-fees" | 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-crm-fees" | 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 Fees API.
Create reusable fee records via POST /crm/v3/objects/fees
Update fee labels or amounts with PATCH /crm/v3/objects/fees/{feeId}
Search fees by amount, label, or custom property through POST /crm/v3/objects/fees/search
Bulk-import a fee catalogue with POST /crm/v3/objects/fees/batch/create
Upsert fees by external ID using POST /crm/v3/objects/fees/batch/upsert
Archive obsolete fees via DELETE /crm/v3/objects/fees/{feeId}
Use Cases
Patterns agents use Fees API for, with concrete tasks.
★ Fee Catalogue Management
Maintain a single source of truth for shipping, handling, and processing fees so quotes are consistent across reps. The batch create endpoint imports a fee list in one request, and the search endpoint lets a quote generator pick fees by region or service tier. Updating a fee centrally propagates the new amount to every quote that references the fee record.
Batch-create six regional shipping fees via POST /crm/v3/objects/fees/batch/create with a region property set to NA, EU, or APAC.
Quote-Time Fee Lookup
When generating a quote, search for the right fee - for example, 'standard shipping NA' - and attach it to the quote so totals reflect the correct charge. The search endpoint accepts filterGroups, sorting, and paginated results so a quote generator can fetch candidates fast even with hundreds of active fees. Apply the fee ID through the Quotes API afterwards.
Search HubSpot fees where label contains 'shipping' and region equals NA, sorted by hs_value ascending, returning the top result.
Fee Reconciliation
Pull all fees referenced on closed-won deals to reconcile billed amounts against the commission or finance system. The list and batch read endpoints retrieve fee records by ID with their full property set, so a reconciliation job can match each fee to the corresponding ledger line.
Batch-read fees for the IDs referenced on last quarter's closed deals via POST /crm/v3/objects/fees/batch/read, returning hs_label and hs_value.
Agent-Driven Fee Updates via Jentic
An AI ops agent reading a memo about a price change updates HubSpot fee records without an engineer touching the CRM. Through Jentic the agent searches for the patch operation, loads its schema, and executes it with the new amount. The flow runs on a single Jentic credential without exposing the HubSpot key.
Use Jentic to search 'update a HubSpot fee record', load the PATCH /crm/v3/objects/fees/{feeId} schema, and execute it with the new hs_value.
Key Endpoints
11 endpoints — the hubspot fees api manages fee records used on quotes and line items, exposing single and batch crud plus search across /crm/v3/objects/fees.
METHOD
PATH
DESCRIPTION
GET
/crm/v3/objects/fees
List fees with pagination
POST
/crm/v3/objects/fees
Create a fee record
PATCH
/crm/v3/objects/fees/{feeId}
Update a fee
POST
/crm/v3/objects/fees/batch/create
Batch-create up to 100 fees
POST
/crm/v3/objects/fees/batch/upsert
Batch-upsert fees by external ID
POST
/crm/v3/objects/fees/search
Search fees by property filters
GET
/crm/v3/objects/fees
List fees with pagination
POST
/crm/v3/objects/fees
Create a fee record
PATCH
/crm/v3/objects/fees/{feeId}
Update a fee
POST
/crm/v3/objects/fees/batch/create
Batch-create up to 100 fees
POST
/crm/v3/objects/fees/batch/upsert
Batch-upsert fees by external ID
POST
/crm/v3/objects/fees/search
Search fees by property filters
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the HubSpot Fees API by hand means handling its OAuth 2.0 authorization-code flow or a private app token, targeting api.hubapi.com, and building batch and search payloads yourself. Through Jentic you install once, import HubSpot Fees from the API Directory, store the token once, and your agent calls it.
Permission scoping
HubSpot gates this API with per-object OAuth scopes, so you grant only the fee scopes your agent needs and you choose which operations it may call: you can allow reading and searching fee records while leaving create and update out of the allowed set unless you add them.
Credential isolation
Your HubSpot OAuth token 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 'create a HubSpot fee record' or 'list fee records', and Jentic returns the matching fees operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Fees API through Jentic.
What authentication does the HubSpot Fees API use?
Fees accepts OAuth 2.0 access tokens and HubSpot private app API keys passed in the private-app or private-app-legacy header. Through Jentic the credential lives in your Jentic One instance and is injected at execution time so it never enters the agent's context.
Can I attach a fee to a quote through this API?
The Fees API only manages the fee records themselves. To attach a fee to a quote or line item, reference its ID through the Quotes or Line Items APIs - Jentic exposes those as separate operations you can chain after creating the fee.
What are the rate limits for the HubSpot Fees API?
Account-level limits apply - typically 100 requests per 10 seconds for OAuth apps and 190 per 10 seconds for private apps on paid tiers. Use POST /crm/v3/objects/fees/batch/create for catalogue imports since each batch counts as one request.
How do I search fees through Jentic?
Run jentic.search('search HubSpot fee records'), load the schema for POST /crm/v3/objects/fees/search, and execute it with a filterGroups payload (for example, hs_label contains 'shipping'). Jentic returns matching fees as structured JSON ready for the next step.
Can I upsert a fee by an external ID?
Yes. POST /crm/v3/objects/fees/batch/upsert accepts an idProperty referencing a unique custom property such as an internal SKU. HubSpot inserts new fees and updates existing ones in the same call without producing duplicates.
What is the difference between a fee and a discount in HubSpot?
Fees add to a quote total (shipping, handling, processing). Discounts subtract from a quote total (percentage off, promotional reductions). Both attach to quotes, but they live as separate object types and are managed through their own APIs.
Can I limit what my agent is allowed to do with the HubSpot Fees API?
Yes. Because your Jentic One instance is self-hosted, you decide which fee operations the agent may call and which credentials it uses. For example, you can allow reading and searching fee records via GET /crm/v3/objects/fees and POST /crm/v3/objects/fees/search while leaving create, update, and archive out of the allowed set. This lines up with HubSpot's per-object OAuth scopes, so the agent only ever exercises the fee operations you have explicitly granted.
GET STARTED