---
title: "Update an event subscription"
method: PATCH
path: "/webhooks/v3/{appId}/subscriptions/{subscriptionId}"
tags: ["Basic"]
---

# Update an event subscription

`PATCH /webhooks/v3/{appId}/subscriptions/{subscriptionId}`

Update an existing event subscription by ID.

## Path parameters

- `appId` integer, required
- `subscriptionId` integer, required

## Request body

- SubscriptionPatchRequest — Updated details for the subscription.
  - `active` boolean — A boolean indicating 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.

## Response `200`

successful operation

- SubscriptionResponse — Complete details for an event subscription.
  - `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).

## Other responses

- `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` — 48 warning, 50 info
  - added the new `company.associationChange` enum value to the `eventType` response property for the response status `200`
  - added the new `company.creation` enum value to the `eventType` response property for the response status `200`
  - added the new `company.deletion` enum value to the `eventType` response property for the response status `200`
  - added the new `company.merge` enum value to the `eventType` response property for the response status `200`
  - …94 more
- **2026-06-15** (v3) `79cf1425dd5b` — 48 warning, 50 info
  - added the new `COMPANY_ASSOCIATION_CHANGE` enum value to the `eventType` response property for the response status `200`
  - added the new `COMPANY_CREATION` enum value to the `eventType` response property for the response status `200`
  - added the new `COMPANY_DELETION` enum value to the `eventType` response property for the response status `200`
  - added the new `COMPANY_MERGE` enum value to the `eventType` response property for the response status `200`
  - …94 more
- **2026-06-15** (v3) `7d5d1828a852` — 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`

[Full history](https://skmtc.dev/hubspot/apis/webhooks-webhooks/changes/webhooks/v3/:appId/subscriptions/:subscriptionId/patch.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/1de03ff22d05/schema)