Fees

Name: Fees API
Brand: Fees
Availability: InStock

✓ Official Vendor SpecCRMDeal 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.

Quickstart

Get started with Fees in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"create a HubSpot fee record"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

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

GET STARTED

Start building with Fees API

Explore with Jentic

View OpenAPI Document

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

Why though 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 a scoped execution token — the raw HubSpot credential is injected at call time and never enters the agent's context.

Intent-based discovery

Agents search Jentic by intent (e.g., 'create a HubSpot fee record') and Jentic returns the matching /crm/v3/objects/fees operation with its input schema, so the agent calls the right endpoint without browsing HubSpot docs.

Time to first call

Direct HubSpot integration: 1-2 days for OAuth scopes and batch payload assembly. Through Jentic: under 1 hour — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

HubSpot Quotes

Attach fee records to customer-facing quotes

Use Quotes after creating or finding a fee to attach the fee ID to the quote document.

Complementary

HubSpot Line Items

Apply fees alongside product line items on a deal or quote

Use Line Items when fees need to be applied at the individual product level rather than as a quote-wide charge.

Complementary

HubSpot Discounts

Discounts are the inverse pattern — subtract from quote totals

Use Discounts when the agent needs to reduce a quote total rather than add a charge.

Alternative

Salesforce

Salesforce CPQ adds product-level surcharges through its own data model

Choose Salesforce CPQ when the organisation already runs CPQ workflows and needs Apex-based fee logic.

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