HUhubspot
Basic

Create webhook subscription

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.

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

Path parameters

appIdstring required

Request body

webhookUrlstring required

The URL to which webhook events will be sent. This must be a valid URL in string format.

Response

successful operation

appIdinteger required

The unique identifier of the application that owns the webhook subscription. It is an integer.

createdAtinteger required

The timestamp when the webhook subscription was created, represented as an integer in int64 format.

createdByUserIdinteger

The unique identifier of the user who created the webhook subscription. It is an integer.

idinteger required

The unique identifier of the webhook subscription. It is an integer formatted as int64.

portalIdinteger required

The unique identifier of the HubSpot portal associated with the webhook subscription. It is an integer.

updatedAtinteger required

The timestamp when the webhook subscription was last updated, represented as an integer in int64 format.

webhookUrlstring required

The URL to which the webhook events will be sent. It is a string.

Changes

No recorded changes to this operation across all 2 revisions of this API.