---
title: "Retrieve subscriptions"
method: GET
path: "/meta/network-origins/2026-09/ip-ranges/webhook-subscriptions/{appId}"
tags: ["Basic"]
---

# Retrieve subscriptions

`GET /meta/network-origins/2026-09/ip-ranges/webhook-subscriptions/{appId}`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/meta/network-origins/2026-09/ip-ranges/webhook-subscriptions/{appId}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `origins.ip_ranges.webhook.read`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `origins.ip_ranges.webhook.write`

Retrieve the list of webhook subscriptions for a specific app identified by the appId. This endpoint returns the webhook subscription details associated with the provided appId, allowing you to manage and monitor webhook integrations effectively.

## Path parameters

- `appId` string, required

## Response `200`

successful operation

- CollectionResponseWebhookSubscriptionNoPaging
  - `results` WebhookSubscription[], required: An array of webhook subscriptions. Each item in the array is a WebhookSubscription object.
    - `appId` integer, required: The unique identifier of the application that owns the webhook subscription. It is an integer.
    - `createdAt` integer, required: The timestamp when the webhook subscription was created, represented as an integer in int64 format.
    - `createdByUserId` integer: The unique identifier of the user who created the webhook subscription. It is an integer.
    - `id` integer, required: The unique identifier of the webhook subscription. It is an integer formatted as int64.
    - `portalId` integer, required: The unique identifier of the HubSpot portal associated with the webhook subscription. It is an integer.
    - `updatedAt` integer, required: The timestamp when the webhook subscription was last updated, represented as an integer in int64 format.
    - `webhookUrl` string, required: The URL to which the webhook events will be sent. It is a string.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-10-10** (2026-09) `f12657790e93`: 2 info
  - the security scope `origins.ip_ranges.webhook.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `origins.ip_ranges.webhook.write` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/meta-origins/changes/meta/network-origins/2026-09/ip-ranges/webhook-subscriptions/:appId/get.md)

---

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