---
title: "Update webhook settings"
method: PUT
path: "/webhooks/v3/{appId}/settings"
tags: ["Basic"]
---

# Update webhook settings

`PUT /webhooks/v3/{appId}/settings`

Update webhook settings for the specified app.

## Path parameters

- `appId` integer, required

## Request body

- SettingsChangeRequest — New or updated webhook settings for an app.
  - `targetUrl` string, required — A publicly available URL for HubSpot to call where event payloads will be delivered. This URL must be accessible to receive event notifications.
  - `throttling` ThrottlingSettings, required — Configuration details for webhook throttling.
    - `maxConcurrentRequests` integer, required — The maximum number of HTTP requests HubSpot will attempt to make to your app in a given time frame determined by `period`. This is an integer value.

## Response `200`

successful operation

- SettingsResponse — Webhook settings for an app.
  - `createdAt` string, date-time, required — When this subscription was created, formatted as a date-time string.
  - `targetUrl` string, required — A publicly available URL for HubSpot to call where event payloads will be delivered.
  - `throttling` ThrottlingSettings, required — Configuration details for webhook throttling.
    - `maxConcurrentRequests` integer, required — The maximum number of HTTP requests HubSpot will attempt to make to your app in a given time frame determined by `period`. This is an integer value.
  - `updatedAt` string, date-time — When this subscription was last updated, formatted as a date-time string.

## Other responses

- `default` — An error occurred.

## Changes

- **2026-04-15** (v3) `c0f40bebcc2e` — 4 info
  - the endpoint scheme security `app_cookie` was removed from the API
  - the endpoint scheme security `developer_hapikey` was removed from the API
  - the endpoint scheme security `internal_cookie` was removed from the API
  - the endpoint scheme security `shhkey` was removed from the API
- **2026-04-12** (v3) `a3ae7c22ab5a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hubspot/apis/webhooks-webhooks/changes/webhooks/v3/:appId/settings/put.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-service-production.skmtc.workers.dev/v1/apis/hubspot/webhooks-webhooks/revisions/c0f40bebcc2e/schema)