Skip to main content
POST
/
webhooks
/
2026-03
/
{appId}
/
subscriptions
/
batch
/
update
Batch create event subscriptions
curl --request POST \
  --url https://api.hubapi.com/webhooks/2026-03/{appId}/subscriptions/batch/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "active": true,
      "id": 123
    }
  ]
}
'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "active": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "eventTypeName": "<string>",
      "objectTypeId": "<string>",
      "propertyName": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "links": {},
  "requestedAt": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Supported products

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

appId
integer<int32>
required

The identifier for the app.

Body

application/json
inputs
object[]
required

An array of SubscriptionBatchUpdateRequest objects, each representing a subscription to be updated. This property is required.

Response

successful operation

completedAt
string<date-time>
required

The date and time when the batch operation was completed, in ISO 8601 format.

results
object[]
required

An array containing the results of the batch operation, with each item representing an individual subscription response.

startedAt
string<date-time>
required

The date and time when the batch operation started, in ISO 8601 format.

status
enum<string>
required

The current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.

Available options:
CANCELED,
COMPLETE,
PENDING,
PROCESSING

A map of link names to associated URIs providing additional information about the batch operation.

requestedAt
string<date-time>

The date and time when the batch operation was requested, in ISO 8601 format.

Last modified on April 14, 2026