Account & Settings
Gestion des applications
Authentification
Automatisation
CMS
Communication preferences
Conversations
Événements
Fichiers
Marketing
Scheduler
curl --request POST \
--url 'https://api.hubapi.com/webhooks/2026-03/{appId}/subscriptions?hapikey=' \
--header 'Content-Type: application/json' \
--data '
{
"active": true,
"eventType": "company.associationChange",
"eventTypeName": "<string>",
"objectTypeId": "<string>",
"propertyName": "<string>"
}
'{
"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"
}Create an event subscription
Create new event subscription for the specified app.
curl --request POST \
--url 'https://api.hubapi.com/webhooks/2026-03/{appId}/subscriptions?hapikey=' \
--header 'Content-Type: application/json' \
--data '
{
"active": true,
"eventType": "company.associationChange",
"eventTypeName": "<string>",
"objectTypeId": "<string>",
"propertyName": "<string>"
}
'{
"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
Supported products
Autorisations
Paramètres de chemin
The ID of the target app.
Corps
Determines if the subscription is active or paused. Defaults to false.
Type of event to listen for. Can be one of create, delete, deletedForPrivacy, or propertyChange.
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 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.
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.
The internal name of the property to monitor for changes. Only applies when eventType is propertyChange.
Réponse
successful operation
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.
The timestamp when the webhook subscription was created, in ISO 8601 format (e.g., 2020-02-29T12:30:00Z).
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.
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 The unique ID of the webhook subscription.
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.
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.
The internal name of the property to monitor for changes. Only applies when eventType is propertyChange.
The timestamp when the webhook subscription was last updated, in ISO 8601 format (e.g., 2020-02-29T12:30:00Z).