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

# 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

- WebhooksSubscriptionPatchRequest — Updated details for the subscription.
  - `active` boolean — Determines if the subscription is active or paused.

## Response `200`

successful operation

- WebhooksSubscriptionResponse — Complete details for an event subscription.
  - `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' | '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`.
  - `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](#).

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.dev/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.dev/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/revisions/6f56ac6a8fa3/schema)
