HubSpot Subscriptions

Name: Subscriptions API
Brand: HubSpot Subscriptions
Availability: InStock

✓ Official Vendor SpecPaymentsBilling Subscriptionsoauth2,apiKey11 EndpointsREST

Install Jentic One Beta

Connect the Subscriptions to your agent

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

Create subscription records with billing cycle, next renewal date, and status properties

Batch upsert subscriptions by an external billing id to keep HubSpot in sync without duplicates

Search subscriptions by status, contact, or renewal date using filter groups

GET STARTED

Start building with Subscriptions API

Explore with Jentic

View OpenAPI Document

For Agents

Create, read, update, archive, search, and upsert HubSpot Commerce subscription records, with batch endpoints for syncing recurring billing state from an external billing system.

Use for: I need to create a subscription record in HubSpot Commerce, Retrieve a subscription by its CRM ID, Search for subscriptions renewing in the next 7 days, Update a subscription status to cancelled

Not supported: Does not handle billing, dunning, or cancellation at an external processor — use only for managing HubSpot CRM subscription records.

The HubSpot Commerce Subscriptions API manages subscription records inside HubSpot Commerce — the CRM-side representation of a recurring billing relationship between a contact and a product. It exposes the standard CRM v3 object pattern with batch read, create, update, archive, search, and upsert against the subscriptions object. Each subscription can carry properties such as billing cycle, next renewal date, status, and associated contact, deal, and line items, mirroring an external billing system into the CRM.

Use Cases

Patterns agents use Subscriptions API for, with concrete tasks.

★ Billing System Mirror

Mirror subscription state from an external billing platform into HubSpot so sales and customer success can see active and at-risk subscriptions in the CRM. The batch upsert endpoint handles up to 100 subscriptions per request keyed on the billing system's subscription id, eliminating duplicates from retried webhooks.

POST 100 subscription payloads to /crm/v3/objects/subscriptions/batch/upsert with idProperty = external_subscription_id and hs_status from the billing source.

Renewal Pipeline

Search for subscriptions renewing in the next two weeks so customer success can run a renewal play. The search endpoint filters by hs_next_renewal_date and status, returning the subscription id, contact id, and amount for the renewal queue.

POST /crm/v3/objects/subscriptions/search with filterGroups for hs_status = ACTIVE and hs_next_renewal_date in the next 14 days, returning hs_amount and contact id.

Churn Analysis

Search for subscriptions cancelled in the last quarter, group by cancellation reason, and feed into a churn dashboard. The CRM-side record keeps cancellation context alongside contact properties for cohort analysis.

Search /crm/v3/objects/subscriptions/search with filterGroups for hs_status = CANCELLED and hs_cancelled_date in the last 90 days, returning hs_cancellation_reason and contact id.

AI Agent Renewal Outreach

An AI agent runs daily to identify upcoming renewals, drafts a personalised outreach message, and assigns a task to the account owner. Jentic exposes the search and contact read operations with typed schemas, so the agent does not need to read HubSpot docs.

Search subscriptions renewing in the next 14 days, fetch the contact owner, and create a task for each owner via the HubSpot tasks API with the renewal context.

Key Endpoints

11 endpoints — the hubspot commerce subscriptions api manages subscription records inside hubspot commerce — the crm-side representation of a recurring billing relationship between a contact and a product.

METHOD

PATH

DESCRIPTION

POST

/crm/v3/objects/subscriptions/batch/create

Create subscription records in batch

POST

/crm/v3/objects/subscriptions/batch/upsert

Idempotent upsert by external id

POST

/crm/v3/objects/subscriptions/batch/read

Read subscriptions in batch by ID

POST

/crm/v3/objects/subscriptions/batch/update

Update subscription properties in batch

POST

/crm/v3/objects/subscriptions/search

Search subscriptions by filter groups

GET

/crm/v3/objects/subscriptions/{subscriptionId}

Retrieve a single subscription

GET

/crm/v3/objects/subscriptions

List subscriptions with pagination

POST

/crm/v3/objects/subscriptions/batch/create

Create subscription records in batch

POST

/crm/v3/objects/subscriptions/batch/upsert

Idempotent upsert by external id

POST

/crm/v3/objects/subscriptions/batch/read

Read subscriptions in batch by ID

POST

/crm/v3/objects/subscriptions/batch/update

Update subscription properties in batch

POST

/crm/v3/objects/subscriptions/search

Search subscriptions by filter groups

Why Jentic?

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

Credential isolation

HubSpot OAuth and private app tokens are encrypted in the Jentic vault. Scoped tokens are injected at execution — raw credentials never appear in agent prompts or logs.

Intent-based discovery

Agents search Jentic by intent (e.g. 'sync subscriptions to hubspot') and Jentic returns the matching subscriptions operation with its typed input schema, so the agent calls the right endpoint without doc lookup.

Time to first call

Direct integration: 2-3 days for OAuth, idempotent upsert against billing webhooks, and association handling. Through Jentic: under 1 hour — search, load schema, execute.

FAQs

Specific to using Subscriptions API through Jentic.

What authentication does the HubSpot Subscriptions API use?

It supports OAuth 2.0 and HubSpot private app tokens. Through Jentic, tokens are stored encrypted in the vault and a scoped token is injected per request, keeping raw credentials out of the agent context.

Can I cancel a subscription via the HubSpot Subscriptions API?

You can update the CRM record (set hs_status to CANCELLED via PATCH /crm/v3/objects/subscriptions/{subscriptionId}) but the API does not cancel billing at an external processor. Cancel at the billing system first, then update the HubSpot record to reflect that state.

What are the rate limits for the HubSpot Subscriptions API?

Standard CRM v3 limits apply — 100 requests per 10 seconds for OAuth apps and 110 per 10 seconds for private apps. Use /crm/v3/objects/subscriptions/batch/upsert (up to 100 records per call) when syncing from a billing system.

How do I upsert subscriptions through Jentic?

Run the Jentic search "upsert hubspot subscription" to find POST /crm/v3/objects/subscriptions/batch/upsert, load the schema, and execute with idProperty set to your billing system's subscription id. Jentic handles authentication.

Is the HubSpot Subscriptions API free?

Access requires HubSpot Commerce Hub. There is no per-call HubSpot fee on top of the Commerce subscription, but the underlying tier price applies.

Can I associate a subscription with a deal and a contact?

Yes — pass an associations array on create, or use the CRM Associations API afterwards, to link a single subscription to a deal, contact, and line items. The single-record GET supports an associations parameter to return linked IDs in one call.

HubSpot Subscriptions

Connect the Subscriptions to your agent

Capabilities

Start building with Subscriptions API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs