HubSpot Companies

Name: Companies API
Brand: HubSpot Companies
Availability: InStock

✓ Official Vendor SpecCRMContact Managementoauth212 EndpointsREST

For Agents

Create, read, update, merge, archive, search, and upsert HubSpot company records, including batch operations and associations to contacts and deals.

Install Jentic One Beta

Connect the Companies to your agent

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

Create company records with name, domain, and custom property values

Batch upsert companies by domain or external id to keep CRM in sync without duplicates

Merge two company records into a single canonical record using the merge endpoint

GET STARTED

Start building with Companies API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Companies API for, with concrete tasks.

★ Account-Based CRM Sync

Sync company records from a data warehouse or a third-party enrichment provider into HubSpot so sales sees a complete picture of each account. Batch upsert by domain handles up to 100 companies per request and avoids duplicates from retried jobs.

POST 100 company payloads to /crm/v3/objects/companies/batch/upsert with idProperty = domain and properties including name, industry, and annualrevenue.

Duplicate Cleanup

When two company records exist for the same organisation, merge them into a single canonical record using the merge endpoint. The merge preserves associations from both records and is non-reversible, so the typical pattern is a quarterly hygiene job driven by domain matching.

Identify duplicate domains via search, then POST /crm/v3/objects/companies/merge with primaryObjectId and objectIdToMerge to consolidate the records.

Account Segmentation Search

Search companies filtered by industry, revenue band, and lifecycle stage to drive a targeted outreach campaign. The search endpoint supports paging, sorting, and property selection so the export is efficient even on large CRM accounts.

POST /crm/v3/objects/companies/search with filterGroups for industry = SOFTWARE, annualrevenue GTE 10000000, and lifecyclestage = LEAD, returning name and ownerId.

AI Agent Account Enrichment

An AI agent reads each company in HubSpot, calls a third-party enrichment provider to find missing properties (industry, employee count, headquarters), and writes the enriched values back. Jentic exposes the search and update operations with typed schemas, so the agent updates the right fields without doc lookup.

Search companies missing industry, fetch enrichment data per domain, and PATCH /crm/v3/objects/companies/{companyId} with the resolved industry and employee count.

Key Endpoints

12 endpoints — the hubspot companies api manages company records — the primary crm object representing organisations that a hubspot user does business with.

METHOD

PATH

DESCRIPTION

POST

/crm/v3/objects/companies/batch/create

Create company records in batch

POST

/crm/v3/objects/companies/batch/upsert

Idempotent upsert by external id or domain

POST

/crm/v3/objects/companies/batch/read

Read companies in batch by ID

POST

/crm/v3/objects/companies/batch/update

Update company properties in batch

POST

/crm/v3/objects/companies/merge

Merge two company records into one

POST

/crm/v3/objects/companies/search

Search companies by filter groups

GET

/crm/v3/objects/companies/{companyId}

Retrieve a single company

GET

/crm/v3/objects/companies

List companies with pagination

POST

/crm/v3/objects/companies/batch/create

Create company records in batch

POST

/crm/v3/objects/companies/batch/upsert

Idempotent upsert by external id or domain

POST

/crm/v3/objects/companies/batch/read

Read companies in batch by ID

POST

/crm/v3/objects/companies/batch/update

Update company properties in batch

POST

/crm/v3/objects/companies/merge

Merge two company records into one

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 enter the agent's context or logs.

Intent-based discovery

Agents search Jentic by intent (e.g. 'create a hubspot company') and Jentic returns the matching companies operation with its typed input schema, so the agent calls the right endpoint without browsing docs.

Time to first call

Direct integration: 1-3 days for OAuth, batch error handling, and merge logic. Through Jentic: under 1 hour — search, load schema, execute.

FAQs

Specific to using Companies API through Jentic.

What authentication does the HubSpot Companies API use?

It supports OAuth 2.0 and HubSpot private app tokens passed as bearer tokens. Through Jentic, tokens are stored encrypted in the vault and a scoped token is injected per request, so raw credentials never enter the agent context.

Can I merge duplicate companies with the HubSpot Companies API?

Yes — POST /crm/v3/objects/companies/merge with primaryObjectId and objectIdToMerge in the request body. Associations from the merged record transfer to the primary record. The operation is not reversible, so dry-run with a search-and-diff first.

What are the rate limits for the HubSpot Companies API?

Standard CRM v3 limits apply — 100 requests per 10 seconds for OAuth apps and 110 per 10 seconds for private apps on Pro and Enterprise. Use /crm/v3/objects/companies/batch/upsert (up to 100 records per call) when syncing large company lists.

How do I upsert companies by domain through Jentic?

Run the Jentic search "upsert hubspot company by domain" to find POST /crm/v3/objects/companies/batch/upsert, load the schema, and execute with idProperty = domain. Jentic handles authentication and returns per-record results.

Is the HubSpot Companies API free?

The Companies API is included with any HubSpot account, including the free tier. There is no per-call HubSpot fee, but advanced features like custom objects or higher API limits may require a paid tier.

Can I associate a company with deals and contacts in one call?

Yes — pass an associations array on create, or use the CRM Associations API afterwards, to link a single company to deals, contacts, and tickets. The single-record GET supports an associations parameter to return linked IDs in one response.

HubSpot Companies

Connect the Companies to your agent

Capabilities

Start building with Companies API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs