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

# Create webhook subscription

`POST /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: 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`

Create a new webhook subscription for the specified app in your HubSpot account. This endpoint requires a valid webhook URL in the request body. Upon successful creation, the response includes the details of the new subscription along with a URL to access it.

## Path parameters

- `appId` string, required

## Request body

- WebhookSubscriptionRequest
  - `webhookUrl` string, required: The URL to which webhook events will be sent. This must be a valid URL in string format.

## Response `201`

successful operation

- WebhookSubscription
  - `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.

---

[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)