---
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-04-15** (v3) `c0f40bebcc2e` — 4 info
  - the endpoint scheme security `app_cookie` was removed from the API
  - the endpoint scheme security `developer_hapikey` was removed from the API
  - the endpoint scheme security `internal_cookie` was removed from the API
  - the endpoint scheme security `shhkey` was removed from the API
- **2026-04-12** (v3) `a3ae7c22ab5a` — 1 info
  - endpoint added

[Change 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/c0f40bebcc2e/schema)