Saltar al contenido principal
POST
/
webhooks
/
v3
/
{appId}
/
subscriptions
/
batch
/
update
Crear suscripciones a eventos en lote
curl --request POST \
  --url https://api.hubapi.com/webhooks/v3/{appId}/subscriptions/batch/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "active": true,
      "id": 12
    }
  ]
}
'
{
  "completedAt": "2020-04-17T02:19:26.283Z",
  "results": [
    {
      "active": true,
      "createdAt": "2019-06-06T16:56:16.652Z",
      "eventType": "contact.propertyChange",
      "id": "1234",
      "propertyName": "firstname",
      "updatedAt": "2019-08-06T16:56:16.652Z"
    },
    {
      "active": false,
      "createdAt": "2019-06-06T16:56:16.652Z",
      "eventType": "contact.create",
      "id": "4567",
      "updatedAt": "2019-08-06T16:56:16.652Z"
    }
  ],
  "startedAt": "2020-04-17T02:19:26.256Z",
  "status": "COMPLETE"
}

Supported products

Autorizaciones

Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Parámetros de ruta

appId
integer<int32>
requerido

El ID de la aplicación de destino.

Cuerpo

application/json

Updated details for the specified subscriptions.

inputs
object[]
requerido

Una matriz de objetos SubscriptionBatchUpdateRequest, cada uno de los cuales representa la configuración actualizada de una suscripción de webhook específica en la operación por lotes.

Respuesta

successful operation

completedAt
string<date-time>
requerido

La marca de tiempo en que se completó la operación por lotes, en formato ISO 8601.

results
object[]
requerido

Una matriz que contiene las suscripciones de webhook procesadas correctamente de la operación por lotes.

startedAt
string<date-time>
requerido

La marca de tiempo en que se empezó a procesar la operación por lotes, en formato ISO 8601.

status
enum<string>
requerido

El estado de la operación por lotes. Los valores aceptados son "PENDING", "PROCESSING", "CANCELED" o "COMPLETE".

Opciones disponibles:
CANCELED,
COMPLETE,
PENDING,
PROCESSING

Un objeto que contiene varias URL para recursos u operaciones relacionadas.

requestedAt
string<date-time>

La marca de tiempo en que se solicitó la operación por lotes, en formato ISO 8601.

Última modificación el 13 de abril de 2026