Skip to main content
PATCH
/
webhooks
/
v3
/
{appId}
/
subscriptions
/
{subscriptionId}
Update an event subscription
curl --request PATCH \
  --url 'https://api.hubapi.com/webhooks/v3/{appId}/subscriptions/{subscriptionId}?hapikey=' \
  --header 'Content-Type: application/json' \
  --data '{
  "active": true
}'
{
  "active": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "eventType": "company.associationChange",
  "id": "<string>",
  "eventTypeName": "<string>",
  "objectTypeId": "<string>",
  "propertyName": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Supported products

Requires one of the following products or higher.
Marketing HubMarketing Hub -Free
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Free
Data HubData Hub -Free

Authorizations

​
hapikey
string
query
required

Path Parameters

​
appId
integer<int32>
required
​
subscriptionId
integer<int32>
required

Body

application/json

Updated details for the subscription.

​
active
boolean

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

successful operation

Complete details for an event subscription.

​
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.

​
createdAt
string<date-time>
required

When this subscription was created. Formatted as milliseconds from the Unix epoch.

​
eventType
enum<string>
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.

Available options:
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
​
id
string
required

The unique ID of the subscription.

​
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.

​
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>

When this subscription was last updated. Formatted as milliseconds from the Unix epoch.

Last modified on February 12, 2026