---
title: "Batch create event subscriptions"
method: POST
path: "/webhooks/v3/{appId}/subscriptions/batch/update"
tags: ["Batch"]
---

# Batch create event subscriptions

`POST /webhooks/v3/{appId}/subscriptions/batch/update`

Batch create event subscriptions for the specified app.

## Path parameters

- `appId` integer, required

## Request body

- BatchInputSubscriptionBatchUpdateRequest
  - `inputs` SubscriptionBatchUpdateRequest[], required — An array of SubscriptionBatchUpdateRequest objects, each representing the updated settings for a specific webhook subscription in the batch operation.
    - `active` boolean, required — Whether to activate or pause the webhook subscription. If true, the subscription will send webhook notifications. If false, the subscription is paused and will not send notifications. It is a boolean.
    - `id` integer, required — The ID of the webhook subscription to update. It is an integer.

## Response `200`

successful operation

- BatchResponseSubscriptionResponse
  - `completedAt` string, date-time, required — The timestamp when the batch operation completed, in ISO 8601 format.
  - `links` object — 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.
  - `results` SubscriptionResponse[], required — An array containing the successfully processed webhook subscriptions from the batch operation.
    - `active` boolean, required — Whether the subscription is active or paused. If true, the subscription will send webhook notifications. If false, the subscription is paused and will not send notifications.
    - `createdAt` string, date-time, required — The timestamp when the webhook subscription was created, in ISO 8601 format (e.g., 2020-02-29T12:30:00Z).
    - `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 to listen for. Accepted values include contact.creation, contact.deletion, contact.propertyChange, and similar event types for other CRM objects and custom objects.
    - `eventTypeName` string — The name of the event to listen for. This is used with custom objects to specify custom event types beyond the standard eventType enum values.
    - `id` string, required — The unique ID of the webhook subscription.
    - `objectTypeId` string — The ID of the object type for the subscription. This can be a standard CRM object (e.g., 'contact', 'company', 'deal') or a custom object ID for custom object subscriptions.
    - `propertyName` string — The internal name of the property to monitor for changes. Only applies when eventType is propertyChange.
    - `updatedAt` string, date-time — The timestamp when the webhook subscription was last updated, in ISO 8601 format (e.g., 2020-02-29T12:30:00Z).
  - `startedAt` string, date-time, required — The timestamp when the batch operation started processing, in ISO 8601 format.
  - `status` 'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING', required — The status of the batch operation. Accepted values are 'PENDING', 'PROCESSING', 'CANCELED', or 'COMPLETE'.

## Other responses

- `207` — multiple statuses
- `default` — An error occurred.

## Changes

- **2026-07-13** (v3) `1de03ff22d05` — 1 info
  - endpoint added
- **2026-07-13** (v3) `9b6da0a3401a` — 1 breaking
  - api path removed without deprecation
- **2026-06-15** (v3) `1de03ff22d05` — 96 warning, 98 info
  - added the new `company.associationChange` enum value to the `results/items/eventType` response property for the response status `200`
  - added the new `company.associationChange` enum value to the `results/items/eventType` response property for the response status `207`
  - added the new `company.creation` enum value to the `results/items/eventType` response property for the response status `200`
  - added the new `company.creation` enum value to the `results/items/eventType` response property for the response status `207`
  - …190 more
- **2026-06-15** (v3) `79cf1425dd5b` — 96 warning, 98 info
  - added the new `COMPANY_ASSOCIATION_CHANGE` enum value to the `results/items/eventType` response property for the response status `200`
  - added the new `COMPANY_ASSOCIATION_CHANGE` enum value to the `results/items/eventType` response property for the response status `207`
  - added the new `COMPANY_CREATION` enum value to the `results/items/eventType` response property for the response status `200`
  - added the new `COMPANY_CREATION` enum value to the `results/items/eventType` response property for the response status `207`
  - …190 more
- …earlier changes not shown

[Full history](https://skmtc.dev/hubspot/apis/webhooks-webhooks/changes/webhooks/v3/: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/1de03ff22d05?raw)