Saltar al contenido principal
GET
/
webhooks
/
v3
/
{appId}
/
subscriptions
/
{subscriptionId}
Leer una suscripción a eventos
curl --request GET \
  --url 'https://api.hubapi.com/webhooks/v3/{appId}/subscriptions/{subscriptionId}?hapikey='
{
  "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"
}
Productos compatibles
Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing HubPro
Sales HubSales HubPro
Service HubService HubPro
Content HubContent HubStarter

Autorizaciones

​
hapikey
string
query
requerido

Parámetros de ruta

​
appId
integer<int32>
requerido

El ID de la aplicación.

​
subscriptionId
integer<int32>
requerido

El ID de la suscripción a eventos.

Respuesta

successful operation

Complete details for an event subscription.

​
active
boolean
requerido

Si activar o pausar la suscripción al webhook. Si es verdadero, la suscripción enviará notificaciones de webhook. Si es falso, significa que la suscripción está en pausa y no enviará notificaciones.

​
createdAt
string<date-time>
requerido

Cuando se creó esta suscripción. Formateado como milisegundos desde la época Unix.

​
eventType
enum<string>
requerido

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.

Opciones disponibles:
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
requerido

El ID único de la suscripción.

​
eventTypeName
string

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.

​
objectTypeId
string

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.

​
propertyName
string

El nombre interno de la propiedad que se monitorizará en busca de cambios. Solo se aplica cuando eventType es propertyChange.

​
updatedAt
string<date-time>

Cuando se actualizó por última vez esta suscripción. Formateado como milisegundos desde la Unix epoch.

Last modified on January 23, 2026