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

# POST /app-webhooks/2026-09/{appId}/subscriptions/batch/update

`POST /app-webhooks/2026-09/{appId}/subscriptions/batch/update`

## Path parameters

- `appId` integer, required

## Request body

- BatchInputSubscriptionBatchUpdateRequest
  - `inputs` SubscriptionBatchUpdateRequest[], required
    - `active` boolean, required
    - `id` integer, required

## Response `200`

successful operation

- BatchResponseSubscriptionResponse
  - `completedAt` string, date-time, required — The date and time when the batch operation was completed.
  - `errors` StandardError[]
    - `category` string, required — The main category of the error.
    - `context` object, required — Additional context-specific information related to the error.
    - `errors` ErrorDetail[], required — The detailed error objects.
      - `code` string — The status code associated with the error detail
      - `context` object — Context about the error condition
      - `in` string — The name of the field or parameter in which the error was found.
      - `message` string, required — A human readable message describing the error along with remediation steps where appropriate
      - `subCategory` string — A specific category that contains more specific detail about the error
    - `id` string — A unique ID for the error instance.
    - `links` object, required — URLs linking to documentation or resources associated with the error.
    - `message` string, required — A human-readable string describing the error and possible remediation steps.
    - `status` string, required — The HTTP status code associated with the error.
    - `subCategory` object — A more specific error category within each main category.
  - `links` object — A collection of related links associated with the batch operation.
  - `numErrors` integer
  - `requestedAt` string, date-time — The date and time when the batch operation was requested.
  - `results` SubscriptionResponse[], required — The list of results from the batch operation.
    - `active` boolean, required — Determines if the subscription is active or paused.
    - `createdAt` string, date-time, required — When this subscription was created. Formatted as milliseconds from the [Unix epoch](#).
    - `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 — Type of event to listen for. Can be one of `create`, `delete`, `deletedForPrivacy`, or `propertyChange`.
    - `eventTypeName` string
    - `id` string, required — The unique ID of the subscription.
    - `objectTypeId` string — The identifier of the object type associated with the subscription.
    - `propertyName` string — The internal name of the property being monitored for changes. Only applies when `eventType` is `propertyChange`.
    - `updatedAt` string, date-time — When this subscription was last updated. Formatted as milliseconds from the [Unix epoch](#).
  - `startedAt` string, date-time, required — The date and time when the batch operation started.
  - `status` 'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING', required — The current status of the batch operation, which can be PENDING, PROCESSING, CANCELED, or COMPLETE.

## Other responses

- `default` — An error occurred.

## Changes

- **2026-07-13** (v3) `ed4e80221691` — 1 info
  - endpoint added
- **2026-04-12** (v3) `a3ae7c22ab5a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/hubspot/apis/webhooks-webhooks/changes/app-webhooks/2026-09/: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-service-production.skmtc.workers.dev/v1/apis/hubspot/webhooks-webhooks/revisions/ed4e80221691/schema)