HubSpot Companies
Browse all Hubspot APIs✓ 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.
Use for: I need to create a new company record in HubSpot, Retrieve a company by its CRM object ID, Search for companies in a specific industry with revenue above a threshold, Merge two duplicate company records into one
Not supported: Does not handle deals, tickets, or marketing email — use only for HubSpot CRM company records.
The HubSpot Companies API manages company records — the primary CRM object representing organisations that a HubSpot user does business with. It exposes the standard CRM v3 object pattern with batch read, create, update, archive, search, upsert, and merge operations against the companies object. Each company record carries default properties such as name and domain, supports custom properties, and can be associated with contacts, deals, tickets, and other CRM objects.
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.
1
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 | sh2
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 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 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
Search companies by domain, industry, or any property using filter groups
Retrieve a company with associated contacts, deals, and tickets in one call
Update company properties (lifecycle stage, owner, ARR) as the relationship progresses
Archive company records in batch when removing from active CRM views
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
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
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.
Related APIs
Alternatives and complements available in the Jentic catalogue.
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.
GET STARTED