Jentic OSThe workplace. An in-house AI platform for every employeeJentic OneSafe access. Agents reach your systems without holding keysJentic AIRThe foundation. Gets your existing platforms ready for AI
Pricing

GET STARTED

API DirectoryBrowse 10,000+ APIs ready for AI agent integrationDocumentationGuides and API reference

TOOLS

API ScoringCheck your AI readiness using our scorecardArazzo UIVisualize Arazzo workflows as interactive documentationArazzo EditorBuild and edit multi-step API workflows visually

COMMUNITY

GitHubOpen source projects and examplesOpen StandardsBuilt on open specs. Never locked in.
All ResourcesEverything in one placeBlogLatest articles and insightsTech Talk NewsletterAPIs, AI agents, architecture and strategyWebinarsLive sessions and on-demand recordingsReports & WhitepapersOriginal research on enterprise AI
About UsOur mission and teamCareersJoin our teamContactGet in touch
Try it now
Jentic OSJentic OneJentic AIR
Pricing
API DirectoryDocumentationAPI ScoringArazzo UIArazzo EditorGitHubOpen Standards
All ResourcesBlogTech Talk NewsletterWebinarsReports & Whitepapers
About UsCareersContact
Try it now
JenticJentic
Products
  • Jentic OS
  • Jentic One
  • Jentic AIR
For Developers
  • API Directory
  • Documentation
  • GitHub
Company
  • About Jentic
  • Careers
  • Contact Us
  • Trust Centre
ISO/IEC 27001:2022 certification badge issued by Prescient SecurityISO/IEC 27001:2022 certification badge issued by Prescient Security

Information Security Management System

Certified to ISO/IEC 27001:2022 by Prescient Security

AICPA SOC for Service Organizations logoAICPA SOC for Service Organizations logo

SOC 2® Type 1 report

Audited by Prescient Assurance

Terms & Conditions•Privacy Policy•
© 2026 Jentic Technology Ltd. All rights reserved.
2 Grattan Court East, Dublin, D02 VX86, Ireland
Switch to light modeSwitch to dark mode
APIs / Developer Tools / Hubspot / HubSpot Webhooks
HubSpot Webhooks logo

HubSpot Webhooks

Browse all Hubspot APIs
41
AI ReadinessFoundational (D-)41/100
See full scorecard
Official vendor OpenAPI document · agent-readyDeveloper ToolsMonitoring ObservabilityapiKey9 EndpointsREST

For Agents

Manage HubSpot app webhook target URL and the change-event subscriptions that push CRM updates to that URL.

Use for: I need to subscribe to HubSpot contact creation events, Update the webhook target URL for our HubSpot app, List all active webhook subscriptions on our app, Pause a HubSpot webhook subscription temporarily

Not supported: Does not deliver outbound HTTP payloads, store webhook history, or replay missed events - use for managing HubSpot app subscription configuration only.

The HubSpot Webhooks API configures the change-event subscriptions that a HubSpot app pushes to a target URL. It manages the app-level webhook settings such as target URL and throttling, and the per-event subscriptions for specific objects and event types. Subscriptions can be created, paused, batch updated, and deleted so apps stay aligned with the HubSpot data they need to react to in near real time.

Jentic One on GithubView OpenAPI Document

Install Jentic One Beta

Connect the HubSpot Webhooks to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the HubSpot Webhooks, 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-webhooks" | sh
2

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-webhooks" | 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 HubSpot Webhooks API.

Read the current target URL and throttling settings for a HubSpot app's webhooks

Update the webhook target URL and concurrency settings for an app

Delete the app's webhook configuration to stop all delivery

List the active event subscriptions registered on a HubSpot app

Create a new event subscription tied to a specific object type and event

Patch a subscription to enable, disable, or change its filter

Batch update many subscriptions in a single call when toggling a deployment

Use Cases

Patterns agents use HubSpot Webhooks API for, with concrete tasks.

★ Real-time CRM sync into a data warehouse

Subscribe a HubSpot app to contact, company, and deal change events so updates land in a downstream warehouse within seconds rather than waiting for a nightly export. The throttling settings on the app webhook configuration prevent the warehouse ingestion endpoint from being overwhelmed during bulk imports.

Set the target with PUT /webhooks/v3/{appId}/settings, then POST /webhooks/v3/{appId}/subscriptions with eventType='contact.propertyChange' to register the subscription.

Pause webhooks during a deployment

Disable a group of subscriptions in a single batch call before a downstream consumer is restarted, then re-enable them once the new build is healthy. The batch update endpoint avoids per-subscription round trips so the pause window is short and the risk of inconsistent state is small.

Call POST /webhooks/v3/{appId}/subscriptions/batch/update with {id, active:false} for the subscriptions to pause, run the deployment, then call the same endpoint with active:true.

Decommissioning an app safely

Cleanly shut down a retired HubSpot app's event delivery by deleting its subscriptions and webhook configuration so no more events fire toward an endpoint that no longer exists. Auditing the active subscriptions first confirms what is being removed before the destructive call.

Call GET /webhooks/v3/{appId}/subscriptions to enumerate, DELETE each subscriptionId, then DELETE /webhooks/v3/{appId}/settings to remove the target URL configuration.

Agent-driven webhook setup through Jentic

An AI agent handling integration onboarding searches Jentic for the HubSpot subscription create operation, loads the schema, and registers a contact-change subscription against the customer's appId. Jentic injects the developer hapikey from the vault so the agent never holds the raw credential while configuring the app.

Through Jentic, search 'create a HubSpot webhook subscription', load the schema for POST /webhooks/v3/{appId}/subscriptions, and execute it with eventType='contact.creation' for the customer's appId.

Key Endpoints

9 endpoints — the hubspot webhooks api configures the change-event subscriptions that a hubspot app pushes to a target url.

METHOD

PATH

DESCRIPTION

GET

/webhooks/v3/{appId}/settings

Get the app's webhook configuration

PUT

/webhooks/v3/{appId}/settings

Update the app's webhook target URL and throttling

DELETE

/webhooks/v3/{appId}/settings

Remove the webhook configuration for the app

GET

/webhooks/v3/{appId}/subscriptions

List active subscriptions

POST

/webhooks/v3/{appId}/subscriptions

Create a new subscription

PATCH

/webhooks/v3/{appId}/subscriptions/{subscriptionId}

Update a single subscription

DELETE

/webhooks/v3/{appId}/subscriptions/{subscriptionId}

Delete a subscription

POST

/webhooks/v3/{appId}/subscriptions/batch/update

Batch update multiple subscriptions

GET

/webhooks/v3/{appId}/settings

Get the app's webhook configuration

PUT

/webhooks/v3/{appId}/settings

Update the app's webhook target URL and throttling

DELETE

/webhooks/v3/{appId}/settings

Remove the webhook configuration for the app

GET

/webhooks/v3/{appId}/subscriptions

List active subscriptions

POST

/webhooks/v3/{appId}/subscriptions

Create a new subscription

PATCH

/webhooks/v3/{appId}/subscriptions/{subscriptionId}

Update a single subscription

DELETE

/webhooks/v3/{appId}/subscriptions/{subscriptionId}

Delete a subscription

POST

/webhooks/v3/{appId}/subscriptions/batch/update

Batch update multiple subscriptions

Jentic AI Readiness Score

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

W

Webhooks Webhooks

- Foundational (D-)
41/100
73
Foundational Compliance
67
Developer Experience & Jentic Compatibility
31
AI-Readiness & Agent Experience
94
Agent Usability
15
Security
69
AI Discoverability
Powered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
73

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: A-Signals: 4
91%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

0%

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

100%

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

67

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: BSignals: 4
16%

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

50%

Response Coverage

Percentage of operations with complete response definitions (success, client error, server error).

100%

Tooling Readiness

Health of API ingestion, bundling, and resolution within Jentic pipelines.

31

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: FSignals: 4
55%

Description Coverage

Coverage of descriptions across API elements.

0%

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

0%

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

69%

Summary Coverage

Coverage of summaries across operations/tags/info.

94

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: A+Signals: 1
94%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

15

Security

Trust, risk posture, and security compliance.

Grade: FSignals: 1
15%

Authentication Strength

Average quality of security schemes based on authentication method strength (weakest link for OAuth2).

69

AI Discoverability

Findability, semantic richness, and reasoning readiness.

Grade: B+Signals: 1
69%

Descriptive Richness

Clarity and depth of descriptions across API elements.

View full reportHow the score is calculatedMore about the dimensions

Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

Score your own APIScoring CLI agent skill
npx @jentic/api-scorecard-cli score <openapi-url>

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring HubSpot Webhooks by hand means holding a developer API key, targeting api.hubapi.com, and passing it as a query parameter on every subscription call yourself. Through Jentic you install once, import HubSpot Webhooks from the API Directory, store the key once, and your agent calls it.

Permission scoping

This API puts the app id in the URL path (/webhooks/v3/{appId}/...), so a rule can pin your agent to one app: it can read and create subscriptions for that app and nothing else. You choose the operations it may call, so deleting settings or a subscription is not included unless you add it.

Credential isolation

Your HubSpot developer API key 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 webhook subscription', and Jentic returns the matching operation with its input schema, including the eventType and propertyName fields, so the agent calls the right endpoint without browsing the HubSpot reference docs.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

HubSpot CRM Contacts

→

Contact records whose change events the webhook subscriptions deliver

Pair with Contacts to fetch the full record after a webhook event delivers only the change payload.

Complementary

HubSpot CRM Deals

→

Deal records whose lifecycle and property change events flow through these webhooks

Subscribe to deal events here, then call CRM Deals to load the full deal context for downstream processing.

Alternative

GitHub

→

Webhook delivery model for source-control events rather than CRM events

Choose GitHub webhooks for source-control events, use HubSpot webhooks for CRM record changes - the two complement different domains.

Alternative

Stripe

Event delivery model for payment-domain events

Use Stripe events for payment lifecycle, use this HubSpot Webhooks API for CRM record lifecycle - many integrations subscribe to both.

FAQs

Specific to using HubSpot Webhooks API through Jentic.

What authentication does the HubSpot Webhooks API use?

Webhook configuration calls authenticate with the HubSpot developer hapikey passed as a query parameter. Through Jentic the developer key sits in your encrypted Jentic One instance and is injected at execution time so the agent configuring webhooks never sees the raw key.

Can I subscribe to property changes on specific HubSpot objects?

Yes. POST /webhooks/v3/{appId}/subscriptions accepts an eventType such as 'contact.propertyChange' along with a propertyName, so the subscription only fires when that specific property changes rather than on every contact update.

What are the rate limits for the HubSpot Webhooks API?

HubSpot enforces standard public API limits - 100 requests per 10 seconds for OAuth apps and 110 per 10 seconds for developer apps. The webhook delivery itself is governed separately by the throttling settings configured on PUT /webhooks/v3/{appId}/settings.

How do I create a webhook subscription through Jentic?

Search Jentic for 'create a HubSpot webhook subscription', load the schema for POST /webhooks/v3/{appId}/subscriptions, and execute it with the appId, eventType, and active flag. Jentic returns the new subscription record with its assigned ID.

Can I temporarily disable a subscription without deleting it?

Yes. PATCH /webhooks/v3/{appId}/subscriptions/{subscriptionId} with active:false pauses delivery while preserving the subscription. Flip active back to true to resume without recreating the subscription.

Does this API let me replay missed events?

No. Replay and retry behaviour is controlled by HubSpot's delivery system based on response codes from the target URL. This API only manages the subscription configuration; it does not expose a manual replay endpoint.

Can I limit what my agent is allowed to do with the HubSpot Webhooks API?

Yes. Because you self-host Jentic One, your own rules decide which operations and credentials the agent may use, and this API puts the app id in the URL path (/webhooks/v3/{appId}/...), so a rule can pin the agent to a single app. You can allow it to read and create subscriptions for that app while withholding destructive calls, so DELETE /webhooks/v3/{appId}/settings and DELETE of a subscription are not available unless you explicitly grant them. The developer API key stays with your Jentic One instance and is injected at execution time, so the agent only ever calls the operations you approve.

GET STARTED

Start building with HubSpot Webhooks API

Explore with Jentic One
View OpenAPI Document