Account & Settings
Gestión de aplicaciones
Autenticación
Automatización
CMS
Communication preferences
Conversaciones
Marketing
Scheduler
curl --request POST \
--url https://api.hubapi.com/webhooks/2026-03/{appId}/subscriptions \
--header 'Authorization: Bearer <token>' \
--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
Crea una nueva suscripción a eventos para la aplicación especificada.
curl --request POST \
--url https://api.hubapi.com/webhooks/2026-03/{appId}/subscriptions \
--header 'Authorization: Bearer <token>' \
--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
Autorizaciones
The access token received from the authorization server in the OAuth 2.0 flow.
Parámetros de ruta
El ID de la aplicación de destino.
Cuerpo
Determina si la suscripción está activa o pausada. Por opción predeterminada, es false.
Tipo de evento a escuchar. Puede ser "create", "delete', "deletedForPrivacy" o "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 El nombre del evento que se detectará. Se usa con objetos personalizados para especificar tipos de eventos personalizados de comportamiento más allá de los valores estándar de la enumeración eventType.
El ID del tipo de objeto para la suscripción. Puede ser un objeto estándar del CRM (por ejemplo, "contacto", "empresa", "negocio") o un ID de objeto personalizado para suscripciones de objetos personalizados.
El nombre interno de la propiedad que se monitoreará en busca de cambios. Solo se aplica cuando "eventType" es "propertyChange".
Respuesta
successful operation
Si la suscripción está activa o en pausa. Si es verdadero, la suscripción enviará notificaciones de webhook. Si es falso, la suscripción está en pausa y no enviará notificaciones.
La marca de tiempo en que se creó la suscripción al webhook, en formato ISO 8601 (por ejemplo, 2020-02-29T12:30:00Z).
El tipo de evento que quieres detectar. Los valores aceptados son contact.creation, contact.deletion, contact.propertyChange y tipos de eventos similares para otros objetos del CRM y objetos personalizados.
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 El ID único de la suscripción al webhook.
El nombre del evento que se detectará. Se usa con objetos personalizados para especificar tipos de eventos personalizados de comportamiento más allá de los valores estándar de la enumeración eventType.
El ID del tipo de objeto para la suscripción. Puede ser un objeto estándar del CRM (por ejemplo, "contacto", "empresa", "negocio") o un ID de objeto personalizado para suscripciones de objetos personalizados.
El nombre interno de la propiedad que se monitorizará en busca de cambios. Solo se aplica cuando eventType es propertyChange.
La marca de tiempo de la última actualización de la suscripción al webhook, en formato ISO 8601 (por ejemplo, 2020-02-29T12:30:00Z).