HUhubspot
Basic

Read an event subscription

Changed on

Retrieve a specific event subscription by ID.

get/webhooks/2026-03/{appId}/subscriptions/{subscriptionId}

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/webhooks/2026-03/{appId}/subscriptions/{subscriptionId}
  • Auth
    • HTTP bearer
    • or API key in query parameter hapikey
    • or none

Path parameters

appIdinteger required

The identifier for the app.

subscriptionIdinteger required

The identifier for the subscription.

Response

successful operation

activeboolean required

A boolean indicating whether the subscription is currently active.

createdAtstring date-time required

The date and time when the subscription was created, in ISO 8601 format.

eventType'company.associationChange' | 'company.creation' | 'company.deletion' | 'company.merge' | 'company.propertyChange' | 'company.restore' | 'contact.associationChange' | 'contact.creation' | 'contact.deletion' | 'contact.merge' | 'contact.privacyDeletion' | 'contact.propertyChange' | 'contact.restore' | 'conversation.creation' | 'conversation.deletion' | 'conversation.newMessage' | 'conversation.privacyDeletion' | 'conversation.propertyChange' | 'deal.associationChange' | 'deal.creation' | 'deal.deletion' | 'deal.merge' | 'deal.propertyChange' | 'deal.restore' | 'event.completed' | 'line_item.associationChange' | 'line_item.creation' | 'line_item.deletion' | 'line_item.merge' | 'line_item.propertyChange' | 'line_item.restore' | 'object.associationChange' | 'object.creation' | 'object.deletion' | 'object.merge' | 'object.propertyChange' | 'object.restore' | 'product.creation' | 'product.deletion' | 'product.merge' | 'product.propertyChange' | 'product.restore' | 'ticket.associationChange' | 'ticket.creation' | 'ticket.deletion' | 'ticket.merge' | 'ticket.propertyChange' | 'ticket.restore' required

The type of event that triggers the subscription. Valid values include various property changes, creations, deletions, merges, restores, and association changes for different HubSpot objects.

eventTypeNamestring

The name of the event type for the subscription.

idstring required

The unique identifier for the subscription. It is an integer formatted as int64.

objectTypeIdstring

The identifier for the object type associated with the subscription. It is a string.

propertyNamestring

The name of the property associated with the subscription event, if applicable.

updatedAtstring date-time

The date and time when the subscription was last updated, in ISO 8601 format.

Changes

Some revisions have not been checked yet.