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

# PUT /app-webhooks/2027-03-beta/{appId}/settings

`PUT /app-webhooks/2027-03-beta/{appId}/settings`

## Request

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

## Path parameters

- `appId` integer, required

## Request body

- SettingsChangeRequest
  - `targetUrl` string, required: The URL to which webhook events will be sent. It is a string.
  - `throttling` ThrottlingSettings, required
    - `maxConcurrentRequests` integer, required: The maximum number of concurrent requests allowed. This is an integer value.

## Response `200`

successful operation

- SettingsResponse
  - `createdAt` string, date-time, required: The date and time when the webhook settings were created, in ISO 8601 format.
  - `targetUrl` string, required: The URL to which the webhook events will be sent. It is a string.
  - `throttling` ThrottlingSettings, required
    - `maxConcurrentRequests` integer, required: The maximum number of concurrent requests allowed. This is an integer value.
  - `updatedAt` string, date-time: The date and time when the webhook settings were 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 `put-/app-webhooks/2027-03-beta/{appId}/settings` removed and replaced with `put-/app-webhooks/2027-03-beta/{appId}/settings_/app-webhooks/2027-03-beta/{appId}/settings`
  - the security scope `developers-write` was added to the endpoint's security scheme `oauth2`
  - the security scope `private-apps-write` was removed from the endpoint's security scheme `oauth2`
- **2026-08-17** (2027-03-beta) `2cd018db1521`: 2 info
  - the security scope `developers-write` was added to the endpoint's security scheme `oauth2`
  - the security scope `private-apps-write` was removed from the endpoint's security scheme `oauth2`
- **2026-08-14** (2027-03-beta) `0d8139833c65`: 2 info
  - the security scope `developers-write` was added to the endpoint's security scheme `oauth2`
  - the security scope `private-apps-write` was removed from the endpoint's security scheme `oauth2`
- **2026-08-14** (2027-03-beta) `6cda86cd0d48`: 2 info
  - the security scope `developers-write` was added to the endpoint's security scheme `oauth2`
  - the security scope `private-apps-write` 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/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.dev/hubspot/apis/webhooks-webhooks/revisions/83a9e3606e9f?raw)