Skip to main content
POST
/
webhooks
/
v3
/
{appId}
/
subscriptions
/
batch
/
update
Batch create event subscriptions
curl --request POST \
  --url https://api.hubapi.com/webhooks/v3/{appId}/subscriptions/batch/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "active": true,
      "id": 12
    }
  ]
}
'
{
  "completedAt": "2020-04-17T02:19:26.283Z",
  "results": [
    {
      "active": true,
      "createdAt": "2019-06-06T16:56:16.652Z",
      "eventType": "contact.propertyChange",
      "id": "1234",
      "propertyName": "firstname",
      "updatedAt": "2019-08-06T16:56:16.652Z"
    },
    {
      "active": false,
      "createdAt": "2019-06-06T16:56:16.652Z",
      "eventType": "contact.create",
      "id": "4567",
      "updatedAt": "2019-08-06T16:56:16.652Z"
    }
  ],
  "startedAt": "2020-04-17T02:19:26.256Z",
  "status": "COMPLETE"
}

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 ID of the target app.

Body

application/json

Updated details for the specified subscriptions.

inputs
object[]
required

An array of SubscriptionBatchUpdateRequest objects, each representing the updated settings for a specific webhook subscription in the batch operation.

Response

successful operation

completedAt
string<date-time>
required

The timestamp when the batch operation completed, in ISO 8601 format.

results
object[]
required

An array containing the successfully processed webhook subscriptions from the batch operation.

startedAt
string<date-time>
required

The timestamp when the batch operation started processing, in ISO 8601 format.

status
enum<string>
required

The status of the batch operation. Accepted values are 'PENDING', 'PROCESSING', 'CANCELED', or 'COMPLETE'.

Available options:
CANCELED,
COMPLETE,
PENDING,
PROCESSING

An object containing URLs for related resources or operations.

requestedAt
string<date-time>

The timestamp when the batch operation was requested, in ISO 8601 format.

Last modified on March 30, 2026