HubSpot · AsyncAPI Specification

HubSpot Webhooks API

Version v3

The HubSpot Webhooks API enables real-time event notifications for changes to CRM objects and conversations in a HubSpot portal. When subscribed events occur, HubSpot delivers HTTP POST requests to a registered target URL containing details about the event. Webhooks support subscription types for contacts, companies, deals, tickets, and conversations.

View Spec View on GitHub AnalyticsCommerceContentCRMCustomer ServiceEmail MarketingMarketingMarketing AutomationOperationsSalesAsyncAPIWebhooksEvents

Channels

contact.creation
subscribe onContactCreation
Contact created
Triggered when a new contact record is created in the portal. The event payload includes the ID of the newly created contact and metadata about the creation event.
contact.deletion
subscribe onContactDeletion
Contact deleted
Triggered when a contact record is deleted (archived) from the portal. The event payload includes the ID of the deleted contact.
contact.propertyChange
subscribe onContactPropertyChange
Contact property changed
Triggered when a property value changes on a contact record. The event payload includes the property name, new value, and the contact's ID.
company.creation
subscribe onCompanyCreation
Company created
Triggered when a new company record is created in the portal.
company.deletion
subscribe onCompanyDeletion
Company deleted
Triggered when a company record is deleted (archived) from the portal.
company.propertyChange
subscribe onCompanyPropertyChange
Company property changed
Triggered when a property value changes on a company record.
deal.creation
subscribe onDealCreation
Deal created
Triggered when a new deal record is created in the portal.
deal.deletion
subscribe onDealDeletion
Deal deleted
Triggered when a deal record is deleted (archived) from the portal.
deal.propertyChange
subscribe onDealPropertyChange
Deal property changed
Triggered when a property value changes on a deal record.
ticket.creation
subscribe onTicketCreation
Ticket created
Triggered when a new ticket record is created in the portal.
ticket.deletion
subscribe onTicketDeletion
Ticket deleted
Triggered when a ticket record is deleted (archived) from the portal.
ticket.propertyChange
subscribe onTicketPropertyChange
Ticket property changed
Triggered when a property value changes on a ticket record.
conversation.creation
subscribe onConversationCreation
Conversation created
Triggered when a new conversation thread is created in the HubSpot conversations inbox.
conversation.deletion
subscribe onConversationDeletion
Conversation deleted
Triggered when a conversation thread is deleted from the portal.
conversation.propertyChange
subscribe onConversationPropertyChange
Conversation property changed
Triggered when a property changes on a conversation thread.
conversation.newMessage
subscribe onConversationNewMessage
New conversation message
Triggered when a new message is added to an existing conversation thread.

Messages

✉
ContactCreationEvent
Contact Creation Event
A contact record was created.
✉
ContactDeletionEvent
Contact Deletion Event
A contact record was deleted.
✉
ContactPropertyChangeEvent
Contact Property Change Event
A contact property value was changed.
✉
CompanyCreationEvent
Company Creation Event
A company record was created.
✉
CompanyDeletionEvent
Company Deletion Event
A company record was deleted.
✉
CompanyPropertyChangeEvent
Company Property Change Event
A company property value was changed.
✉
DealCreationEvent
Deal Creation Event
A deal record was created.
✉
DealDeletionEvent
Deal Deletion Event
A deal record was deleted.
✉
DealPropertyChangeEvent
Deal Property Change Event
A deal property value was changed.
✉
TicketCreationEvent
Ticket Creation Event
A ticket record was created.
✉
TicketDeletionEvent
Ticket Deletion Event
A ticket record was deleted.
✉
TicketPropertyChangeEvent
Ticket Property Change Event
A ticket property value was changed.
✉
ConversationCreationEvent
Conversation Creation Event
A conversation was created.
✉
ConversationDeletionEvent
Conversation Deletion Event
A conversation was deleted.
✉
ConversationPropertyChangeEvent
Conversation Property Change Event
A conversation property was changed.
✉
ConversationNewMessageEvent
Conversation New Message Event
A new message was added to a conversation.

Servers

https
hubspot-api https://api.hubapi.com
HubSpot management API for configuring webhook settings and subscriptions. Webhook events are delivered to the target URL configured in your app settings.