Put /webhooks/v3/{app Id}/settings Configure

Update webhook settings

PUT/webhooks/v3/{appId}/settings

Use it in a workflow

Add a step and choose the HubSpot connector.
Pick the Put /webhooks/v3/{app Id}/settings Configure action (under Webhooks).
Fill in the fields below, then reference the result from later steps as {{putWebhooksV3AppIdSettingsConfigure.response.data}}.

Request

Path parameters

appIdinteger (int32)required

The ID of the target app.

Request body

Enter the body as JSON in the step's Body field.

targetUrlstringrequired

A publicly available URL for HubSpot to call where event payloads will be delivered. This URL must be accessible to receive event notifications.

throttlingobjectrequired

Configuration details for webhook throttling.

maxConcurrentRequestsinteger (int32)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.

json

{
  "targetUrl": "string",
  "throttling": {
    "maxConcurrentRequests": 0
  }
}

Response

Returns 200 with an object. Read it in later steps with {{putWebhooksV3AppIdSettingsConfigure.response.data.<field>}}.

createdAtstring (date-time)

When this subscription was created, formatted as a date-time string.

targetUrlstring

A publicly available URL for HubSpot to call where event payloads will be delivered.

throttlingobject

Configuration details for webhook throttling.

maxConcurrentRequestsinteger (int32)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.

updatedAtstring (date-time)

When this subscription was last updated, formatted as a date-time string.

json

{
  "createdAt": "2025-01-01T00:00:00Z",
  "targetUrl": "string",
  "throttling": {
    "maxConcurrentRequests": 0
  },
  "updatedAt": "2025-01-01T00:00:00Z"
}

Need more? See the HubSpot guide for connection setup and behaviour shared by every action.

Was this page helpful?