Zum Hauptinhalt springen
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": "2019-10-30T03:30:17.883Z",
  "eventType": "contact.propertyChange",
  "id": "12",
  "propertyName": "email",
  "updatedAt": "2019-11-30T03:30:17.883Z"
}

Supported products

Autorisierungen

hapikey
string
query
erforderlich

Pfadparameter

appId
integer<int32>
erforderlich

The ID of the target app.

subscriptionId
integer<int32>
erforderlich

The ID of the subscription to update.

Body

application/json

Updated details for the subscription.

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.

Antwort

successful operation

Complete details for an event subscription.

active
boolean
erforderlich

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

The timestamp when the webhook subscription was created, in ISO 8601 format (e.g., 2020-02-29T12:30:00Z).

eventType
enum<string>
erforderlich

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.

Verfügbare Optionen:
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
erforderlich

The unique ID of the webhook 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>

The timestamp when the webhook subscription was last updated, in ISO 8601 format (e.g., 2020-02-29T12:30:00Z).

Last modified on April 9, 2026