---
title: "POST /app-webhooks/2027-03-beta/{appId}/subscriptions/batch/update"
method: POST
path: "/app-webhooks/2027-03-beta/{appId}/subscriptions/batch/update"
tags: ["Batch"]
---

# POST /app-webhooks/2027-03-beta/{appId}/subscriptions/batch/update

`POST /app-webhooks/2027-03-beta/{appId}/subscriptions/batch/update`

## Request

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

## Path parameters

- `appId` integer, required

## Request body

- BatchInputSubscriptionBatchUpdateRequest
  - `inputs` SubscriptionBatchUpdateRequest[], required: An array of SubscriptionBatchUpdateRequest objects, each representing a subscription to be updated. This property is required.
    - `active` boolean, required: A boolean indicating whether the subscription is active.
    - `id` integer, required: The unique identifier for the subscription. It is an integer.

## Response `200`

successful operation

- BatchResponseSubscriptionResponse
  - `completedAt` string, date-time, required: The date and time when the batch operation was completed, in ISO 8601 format.
  - `links` object: 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.
  - `results` SubscriptionResponse[], required: An array containing the results of the batch operation, with each item representing an individual subscription response.
    - `active` boolean, required: A boolean indicating whether the subscription is currently active.
    - `createdAt` string, date-time, required: The date and time when the subscription was created, in ISO 8601 format.
    - `eventType` 'company.associationChange' | 'company.creation' | 'company.deletion' | 'company.merge' | 'company.propertyChange' | 'company.restore' | 'contact.associationChange' | 'contact.creation' | 'contact.deletion' | 'contact.merge' | 'contact.privacyDeletion' | 'contact.propertyChange' | 'contact.restore' | 'conversation.creation' | 'conversation.deletion' | 'conversation.newMessage' | 'conversation.privacyDeletion' | 'conversation.propertyChange' | 'deal.associationChange' | 'deal.creation' | 'deal.deletion' | 'deal.merge' | 'deal.propertyChange' | 'deal.restore' | 'event.completed' | 'line_item.associationChange' | 'line_item.creation' | 'line_item.deletion' | 'line_item.merge' | 'line_item.propertyChange' | 'line_item.restore' | 'object.associationChange' | 'object.creation' | 'object.deletion' | 'object.merge' | 'object.propertyChange' | 'object.restore' | 'product.creation' | 'product.deletion' | 'product.merge' | 'product.propertyChange' | 'product.restore' | 'ticket.associationChange' | 'ticket.creation' | 'ticket.deletion' | 'ticket.merge' | 'ticket.propertyChange' | 'ticket.restore', required: The type of event that triggers the subscription. Valid values include various property changes, creations, deletions, merges, restores, and association changes for different HubSpot objects.
    - `eventTypeName` string: The name of the event type for the subscription.
    - `id` string, required: The unique identifier for the subscription. It is an integer formatted as int64.
    - `objectTypeId` string: The identifier for the object type associated with the subscription. It is a string.
    - `propertyName` string: The name of the property associated with the subscription event, if applicable.
    - `updatedAt` string, date-time: The date and time when the subscription was last updated, in ISO 8601 format.
  - `startedAt` string, date-time, required: The date and time when the batch operation started, in ISO 8601 format.
  - `status` 'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING', required: The current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.

## Other responses

- `207`: multiple statuses
- `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 `post-/app-webhooks/2027-03-beta/{appId}/subscriptions/batch/update` removed and replaced with `post-/app-webhooks/2027-03-beta/{appId}/subscriptions/batch/update_/app-webhooks/2027-03-beta/{appId}/subscriptions/batch/update`
  - 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`
- …earlier changes not shown

[Operation history](https://skmtc.dev/hubspot/apis/webhooks-webhooks/changes/app-webhooks/2027-03-beta/:appId/subscriptions/batch/update/post.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)