Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Kin Lane

Chat with Kin

AI assistant · trained on my blog

HubSpot

HubSpot Webhooks API

The webhooks API allows you to subscribe to events occurring in a HubSpot account, receiving real-time notifications when CRM objects or conversations are created, updated, or deleted. You can configure subscriptions, manage webhook settings, and validate incoming webhook payloads.

Documentation Provider Profile APIs.io AsyncAPI GitHub

HubSpot Webhooks API is one of 93 APIs that HubSpot publishes on the APIs.io network, described by an AsyncAPI event-driven specification.

Tagged areas include Events, Integrations, and Webhooks. The published artifact set on APIs.io includes API documentation and an AsyncAPI specification.

This event API exposes 16 operations across 16 channels, and defines 23 schemas. It is described by AsyncAPI 2.6.0, at version v3.

The API connects through a single server, https://api.hubapi.com (https).

16 operations 16 channels 23 schemas

Metadata

The identity and technical contract details declared by the specification.

Specification
AsyncAPI 2.6.0
API Version
v3
Base URL
https://api.hubapi.com
Contact
HubSpot Developer Support
License
HubSpot Developer Terms
Resource Areas
1

Channels & Operations 16

Across 16 channels, the API surfaces 16 operations. Each is listed below with its action, channel, parameters, and response codes.

Channels 16
SUB
contact.creation
Contact created
onContactCreation body
SUB
contact.deletion
Contact deleted
onContactDeletion body
SUB
contact.propertyChange
Contact property changed
onContactPropertyChange body
SUB
company.creation
Company created
onCompanyCreation body
SUB
company.deletion
Company deleted
onCompanyDeletion body
SUB
company.propertyChange
Company property changed
onCompanyPropertyChange body
SUB
deal.creation
Deal created
onDealCreation body
SUB
deal.deletion
Deal deleted
onDealDeletion body
SUB
deal.propertyChange
Deal property changed
onDealPropertyChange body
SUB
ticket.creation
Ticket created
onTicketCreation body
SUB
ticket.deletion
Ticket deleted
onTicketDeletion body
SUB
ticket.propertyChange
Ticket property changed
onTicketPropertyChange body
SUB
conversation.creation
Conversation created
onConversationCreation body
SUB
conversation.deletion
Conversation deleted
onConversationDeletion body
SUB
conversation.propertyChange
Conversation property changed
onConversationPropertyChange body
SUB
conversation.newMessage
New conversation message
onConversationNewMessage body

Messages & Schemas 23

The contract defines 23 schemas that model the data carried by its messages. The most detailed are WebhookEventBase (9 properties), WebhookSubscription (5 properties), WebhookSettings (2 properties). Each schema is shown below with its type and property counts.

ContactCreationEvent
message
A contact record was created.
ContactDeletionEvent
message
A contact record was deleted.
ContactPropertyChangeEvent
message
A contact property value was changed.
CompanyCreationEvent
message
A company record was created.
CompanyDeletionEvent
message
A company record was deleted.
CompanyPropertyChangeEvent
message
A company property value was changed.
DealCreationEvent
message
A deal record was created.
DealDeletionEvent
message
A deal record was deleted.
DealPropertyChangeEvent
message
A deal property value was changed.
TicketCreationEvent
message
A ticket record was created.
TicketDeletionEvent
message
A ticket record was deleted.
TicketPropertyChangeEvent
message
A ticket property value was changed.
ConversationCreationEvent
message
A conversation was created.
ConversationDeletionEvent
message
A conversation was deleted.
ConversationPropertyChangeEvent
message
A conversation property was changed.
ConversationNewMessageEvent
message
A new message was added to a conversation.
WebhookEventBase
object
Base properties shared by all HubSpot webhook event payloads. Each webhook notification is delivered as an HTTP POST to your registered target URL with this pa…
9 properties 8 required
CRMCreationEvent
object
CRMDeletionEvent
object
CRMPropertyChangeEvent
object
ConversationMessageEvent
object
WebhookSettings
object
Settings for an app's webhook configuration.
2 properties
WebhookSubscription
object
A webhook event subscription configuration.
5 properties

Specification

The full machine-readable AsyncAPI contract behind this narrative.

Source

hubspot-webhooks-asyncapi.yml Raw ↑

Other APIs HubSpot publishes across the network.

HubSpot Posts API
AE Profile APIs.io
HubSpot URL Redirects API
AE Profile APIs.io
HubSpot Pipelines API
AE Profile APIs.io
HubSpot Products API
AE Profile APIs.io
HubSpot Line Items API
AE Profile APIs.io
HubSpot Quotes API
AE Profile APIs.io
HubSpot CRM Properties API
AE Profile APIs.io
HubSpot Owners API
AE Profile APIs.io
HubSpot CRM Imports API
AE Profile APIs.io
HubSpot Custom Objects API
AE Profile APIs.io
HubSpot Marketing Events API
AE Profile APIs.io
HubSpot Forms API
AE Profile APIs.io
#Events#Integrations#Webhooks
← Back to H APIs
API Details
ID
hubspot:hubspot-webhooks-api
Base URL
https://api.hubapi.com
Docs
https://developers.hubspot.com/docs/api/webhooks
Provider
HubSpot
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network