Skip to main content
PUT
/
webhooks
/
v3
/
{appId}
/
settings
Update webhook settings
curl --request PUT \
  --url 'https://api.hubapi.com/webhooks/v3/{appId}/settings?hapikey=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "targetUrl": "https://www.example.com/hubspot/target",
  "throttling": {
    "maxConcurrentRequests": 10,
    "period": "SECONDLY"
  }
}
'
{
  "targetUrl": "https://www.example.com/hubspot/target",
  "throttling": {
    "maxConcurrentRequests": 10,
    "period": "SECONDLY"
  },
  "createdAt": "2020-01-24T16:27:59Z",
  "updatedAt": "2020-01-24T16:32:43Z"
}

Supported products

Requires one of the following products or higher.
Marketing HubMarketing Hub -Free
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Free
Data HubData Hub -Free

Authorizations

​
hapikey
string
query
required

Path Parameters

​
appId
integer<int32>
required

The ID of the app.

Body

application/json

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.

​
throttling
object
required

Configuration details for webhook throttling.

Response

successful operation

Webhook settings for an app.

​
createdAt
string<date-time>
required

When this subscription was created. Formatted as milliseconds from the Unix epoch.

​
targetUrl
string
required

A publicly available URL for HubSpot to call where event payloads will be delivered. See link-so-some-doc for details about the format of these event payloads.

​
throttling
object
required

Configuration details for webhook throttling.

​
updatedAt
string<date-time>

When this subscription was last updated. Formatted as milliseconds from the Unix epoch.

Last modified on December 16, 2025