HUhubspot
Basic

Retrieve subscription

Changed on

Retrieve details of a specific webhook subscription using its unique identifier. This endpoint is useful for obtaining information about a particular subscription, such as its actions, object type, and associated properties.

get/webhooks-journal/subscriptions/2026-09/{subscriptionId}

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/webhooks-journal/subscriptions/2026-09/{subscriptionId}
  • Auth
    none required

Path parameters

subscriptionIdinteger required

The unique identifier of the subscription to retrieve. It must be an integer.

Response

successful operation

actionOverridesobject

An object containing overrides for actions, where each key is an action and the value is an ActionOverrideRequest object.

actionsstring[] required

An array of actions associated with the subscription. Valid actions include 'CREATE', 'UPDATE', 'DELETE', 'MERGE', 'RESTORE', 'ASSOCIATION_ADDED', 'ASSOCIATION_REMOVED', 'SNAPSHOT', 'APP_INSTALL', 'APP_UNINSTALL', 'ADDED_TO_LIST', 'REMOVED_FROM_LIST', and 'GDPR_DELETE'.

appIdinteger required

The unique identifier for the app associated with the subscription, represented as an integer.

associatedObjectTypeIdsstring[]

An array of strings representing the IDs of associated object types.

createdAtstring date-time required

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

createdByinteger

The unique identifier of the user who created the subscription, represented as an integer.

deletedAtstring date-time

The date and time when the subscription was deleted, in ISO 8601 format, if applicable.

idinteger required

The unique identifier for the subscription, represented as an integer.

listIdsinteger[]

An array of integers representing the IDs of lists associated with the subscription.

objectIdsinteger[]

An array of integers representing the IDs of objects associated with the subscription.

objectTypeIdstring required

The identifier for the type of object associated with the subscription, represented as a string.

portalIdinteger

The unique identifier for the portal associated with the subscription, represented as an integer.

propertiesstring[]

An array of strings representing the properties associated with the subscription.

subscriptionType'APP_LIFECYCLE_EVENT' | 'ASSOCIATION' | 'EVENT' | 'GDPR_PRIVACY_DELETION' | 'LIST_MEMBERSHIP' | 'OBJECT' required

The type of subscription, indicating the nature of events it pertains to. Valid values include 'OBJECT', 'ASSOCIATION', 'EVENT', 'APP_LIFECYCLE_EVENT', 'LIST_MEMBERSHIP', and 'GDPR_PRIVACY_DELETION'.

updatedAtstring date-time required

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

Changes