Última modificación: 11 de septiembre de 2025
Para definir un conjunto de suscripciones a webhooks para una aplicación en la nueva plataforma para desarrolladores, incluye el directorio webhooks en el proyecto, junto con un archivo de configuración *-hsmeta.json.

​
Estructura del directorio

├──src
│   ├── app/
│   │   └── app-hsmeta.json
│   │   └── ...
│   │   └── webhooks/
│   │     └── webhooks-hsmeta.json
└──

​
Configuración del webhook

A continuación, están las opciones de configuración disponibles para el archivo *-hsmeta.json. 
{
  "uid": "webhooks",
  "type": "webhooks",
  "config": {
    "settings": {
      "targetUrl": "https://example.com/webhook",
      "maxConcurrentRequests": 10
    },
    "subscriptions": {
      "crmObjects": [
        {
          "subscriptionType": "object.creation",
          "objectType": "contact",
          "active": true
        }
      ],
      "legacyCrmObjects": [
        {
          "subscriptionType": "contact.propertyChange",
          "propertyName": "lastname",
          "active": true
        },
        {
          "subscriptionType": "contact.deletion",
          "active": true
        }
      ],
      "hubEvents": [
        {
          "subscriptionType": "contact.privacyDeletion",
          "active": true
        }
      ]
    }
  }
}

Los campos marcados con * son obligatorios.

CampoTipoDescripción
uid*CadenaUn identificador único interno para el componente del webhook.
type*CadenaEl tipo de componente, que en este caso debe ser webhooks.
settings*ObjetoUn objeto que especifica dos campos: targetUrl, que es la URL disponible públicamente para que HubSpot llame a donde se entregarán los datos de eventos, y maxConcurrentRequests, que es el umbral superior de peticiones HTTP que HubSpot realizará en un período de tiempo determinado.
subscriptions*ObjetoUn objeto que especifica los tipos de suscripción a los que se suscribirá la aplicación.
crmObjectsMatriz

Matriz que contiene definiciones de suscripción a eventos. Esta es la matriz estándar que hay que incluir, y debe utilizarse para todos los eventos en el nuevo formato (object.*).

Por otra parte, los tipos de suscripción a webhook anteriores deben incluirse en las matrices legacyCrmObjects y hubEvents, dependiendo del evento.

legacyCrmObjectsMatrizMatriz que contiene los tipos de suscripción anteriores, como contact.creation y deal.deletion.
hubEventsMatrizUna matriz que contiene los tipos de suscripción anteriores contact.privacyDeletion y conversation.*
Para cada objeto subscription, se pueden especificar los siguientes campos, dependiendo del tipo de definición de suscripción al que estés suscrito (es decir, crmObjects, legacyCrmObjects o hubEvents) o de si estás suscrito a un cambio de propiedad específico (por ejemplo, contact.propertyChange).
CampoTipoDescripción
subscriptionTypeCadenaEl tipo de evento al que se está suscrito.
objectTypeCadenaPara las suscripciones especificadas en la matriz crmObjects, especifica el objeto del CRM al que se está suscribiendo tu aplicación.
propertyNameCadenaPara las suscripciones de cambio de propiedad, especifica qué propiedad desencadenará el evento del webhook.
activeBooleanoSi se desencadenarán eventos webhook para esta suscripción.