---
title: "Retrieve subscription"
method: GET
path: "/webhooks-journal/subscriptions/2026-09/{subscriptionId}"
tags: ["Basic"]
---

# Retrieve subscription

`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

Retrieve details of a specific webhook subscription using its unique identifier. This endpoint is useful for obtaining information about a particular subscription's configuration and status within the HubSpot account.

## Path parameters

- `subscriptionId` integer, required

## Response `200`

successful operation

- SubscriptionResponse1
  - `actionOverrides` object: An object containing action overrides, where each key is an action and the value is an ActionOverrideRequest object.
  - `actions` string[], required: A list of actions that trigger the subscription. Possible values include 'CREATE', 'UPDATE', 'DELETE', 'MERGE', 'RESTORE', 'ASSOCIATION_ADDED', 'ASSOCIATION_REMOVED', 'SNAPSHOT', 'APP_INSTALL', 'APP_UNINSTALL', 'ADDED_TO_LIST', 'REMOVED_FROM_LIST', and 'GDPR_DELETE'.
  - `appId` integer, required: The unique identifier for the app associated with the subscription. It is an integer formatted as int64.
  - `associatedObjectTypeIds` string[]: A list of associated object type IDs. Each ID is a string.
  - `createdAt` string, date-time, required: The date and time when the subscription was created, in ISO 8601 format.
  - `createdBy` integer: The ID of the user who created the subscription. It is an integer formatted as int64.
  - `deletedAt` string, date-time: The date and time when the subscription was deleted, in ISO 8601 format, if applicable.
  - `id` integer, required: The unique identifier for the subscription. It is an integer formatted as int64.
  - `listIds` integer[]: A list of list IDs associated with the subscription. Each ID is an integer formatted as int64.
  - `objectIds` integer[]: A list of object IDs associated with the subscription. Each ID is an integer formatted as int64.
  - `objectTypeId` string, required: The identifier for the object type associated with the subscription. It is a string.
  - `portalId` integer: The unique identifier for the portal associated with the subscription. It is an integer formatted as int64.
  - `properties` string[]: A list of property names associated with the subscription. Each property is a string.
  - `subscriptionType` 'APP_LIFECYCLE_EVENT' | 'ASSOCIATION' | 'EVENT' | 'GDPR_PRIVACY_DELETION' | 'LIST_MEMBERSHIP' | 'OBJECT', required: The type of subscription, which can be one of the following: 'OBJECT', 'ASSOCIATION', 'EVENT', 'APP_LIFECYCLE_EVENT', 'LIST_MEMBERSHIP', or 'GDPR_PRIVACY_DELETION'.
  - `updatedAt` string, date-time, required: The date and time when the subscription was last updated, in ISO 8601 format.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-21** (2026-09) `140541da601a`: 1 info
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-09-03** (2026-09) `bc692b707bfe`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/webhooks-webhooks/changes/webhooks-journal/subscriptions/2026-09/:subscriptionId/get.md)

---

[API](https://skmtc.dev/hubspot/apis/webhooks-webhooks.md) - [All operations](https://skmtc.dev/hubspot/apis/webhooks-webhooks/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/webhooks-webhooks/revisions/fb70509e8b82?raw)
