---
title: "GET /app-webhooks/2027-03-beta/{appId}/subscriptions"
method: GET
path: "/app-webhooks/2027-03-beta/{appId}/subscriptions"
tags: ["Basic"]
---

# GET /app-webhooks/2027-03-beta/{appId}/subscriptions

`GET /app-webhooks/2027-03-beta/{appId}/subscriptions`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/app-webhooks/2027-03-beta/{appId}/subscriptions`
- Auth: API key in query parameter `hapikey`

## Path parameters

- `appId` integer, required

## Response `200`

successful operation

- SubscriptionListResponse
  - `results` SubscriptionResponse[], required: An array of subscription responses, each detailing a specific subscription's properties and status.
    - `active` boolean, required: A boolean indicating whether the subscription is currently active.
    - `createdAt` string, 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.
    - `eventTypeName` string: The name of the event type for the subscription.
    - `id` string, required: The unique identifier for the subscription. It is an integer formatted as int64.
    - `objectTypeId` string: The identifier for the object type associated with the subscription. It is a string.
    - `propertyName` string: The name of the property associated with the subscription event, if applicable.
    - `updatedAt` string, date-time: The date and time when the subscription was last updated, in ISO 8601 format.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-17** (2027-03-beta) `6995629a4549`: 3 info
  - the endpoint scheme security `developer_hapikey` was added to the API
  - the endpoint scheme security `oauth2` was removed from the API
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-09-09** (2027-03-beta) `14f87d33fd3a`: 3 info
  - api operation id `get-/app-webhooks/2027-03-beta/{appId}/subscriptions` removed and replaced with `get-/app-webhooks/2027-03-beta/{appId}/subscriptions_/app-webhooks/2027-03-beta/{appId}/subscriptions`
  - the security scope `developers-read` was added to the endpoint's security scheme `oauth2`
  - the security scope `private-apps-read` was removed from the endpoint's security scheme `oauth2`
- **2026-08-17** (2027-03-beta) `2cd018db1521`: 2 info
  - the security scope `developers-read` was added to the endpoint's security scheme `oauth2`
  - the security scope `private-apps-read` was removed from the endpoint's security scheme `oauth2`
- **2026-08-14** (2027-03-beta) `0d8139833c65`: 2 info
  - the security scope `developers-read` was added to the endpoint's security scheme `oauth2`
  - the security scope `private-apps-read` was removed from the endpoint's security scheme `oauth2`
- **2026-08-14** (2027-03-beta) `6cda86cd0d48`: 2 info
  - the security scope `developers-read` was added to the endpoint's security scheme `oauth2`
  - the security scope `private-apps-read` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/webhooks-webhooks/changes/app-webhooks/2027-03-beta/:appId/subscriptions/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/83a9e3606e9f?raw)