> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Update event subscriptions in batch
> Crear suscripciones a eventos en lote para la aplicación especificada.
export const SupportedProducts = ({marketing, sales, service, cms, marketingLevel, salesLevel, serviceLevel, cmsLevel}) => {
const translations = {
header: "Productos compatibles",
description: "Se requiere uno de los siguientes productos o productos de ediciones superiores.",
productNames: {
marketing: "Marketing Hub",
sales: "Sales Hub",
service: "Service Hub",
cms: "Content Hub"
},
tiers: {
free: "Gratuito",
starter: "Starter",
professional: "Pro",
enterprise: "Enterprise"
}
};
const translateTier = tier => {
if (!tier) return '';
const lowerTier = tier.toLowerCase();
return translations.tiers[lowerTier] || tier;
};
const products = [{
name: marketing ? translations.productNames.marketing : '',
level: translateTier(marketingLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/marketing-bolt.svg",
alt: "Marketing Hub"
}, {
name: sales ? translations.productNames.sales : '',
level: translateTier(salesLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/sales-star.svg",
alt: "Sales Hub"
}, {
name: service ? translations.productNames.service : '',
level: translateTier(serviceLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/service-heart.svg",
alt: "Service Hub"
}, {
name: cms ? translations.productNames.cms : '',
level: translateTier(cmsLevel),
icon: "https://mintlify-assets.b-cdn.net/Icons/content-play.svg",
alt: "Content Hub"
}].filter(product => product.name && product.level);
if (products.length === 0) return null;
return
{translations.description}
{products.map((product, index) =>
{product.name} -{product.level}
)}
;
};
## OpenAPI
````yaml specs/2026-03/webhooks-webhooks-v2026-03.json POST /webhooks/2026-03/{appId}/subscriptions/batch/update
openapi: 3.0.1
info:
title: Webhooks Webhooks
description: Basepom for all HubSpot Projects
version: 2026-03
x-hubspot-product-tier-requirements:
marketing: FREE
sales: FREE
service: FREE
cms: FREE
commerce: FREE
crmHub: FREE
dataHub: FREE
servers:
- url: https://api.hubapi.com
security: []
tags:
- name: Advanced
- name: Basic
- name: Batch
paths:
/webhooks/2026-03/{appId}/subscriptions/batch/update:
post:
tags:
- Batch
summary: Crear suscripciones a eventos en lote
description: Crear suscripciones a eventos en lote para la aplicación especificada.
operationId: post-/webhooks/2026-03/{appId}/subscriptions/batch/update_updateBatch
parameters:
- name: appId
in: path
description: ''
required: true
style: simple
explode: false
schema:
type: integer
format: int32
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BatchInputSubscriptionBatchUpdateRequest'
required: true
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/BatchResponseSubscriptionResponse'
'207':
description: multiple statuses
content:
application/json:
schema:
$ref: >-
#/components/schemas/BatchResponseSubscriptionResponseWithErrors
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- developers-write
- oauth2:
- private-apps-write
components:
schemas:
BatchInputSubscriptionBatchUpdateRequest:
required:
- inputs
type: object
properties:
inputs:
type: array
description: >-
Un conjunto de objetos SubscriptionBatchUpdateRequest, cada uno de
los cuales representa una suscripción que se actualizará. Esta
propiedad es obligatoria.
items:
$ref: '#/components/schemas/SubscriptionBatchUpdateRequest'
BatchResponseSubscriptionResponse:
required:
- completedAt
- results
- startedAt
- status
type: object
properties:
completedAt:
type: string
description: >-
La fecha y hora en que se completó la operación por lotes, en
formato ISO 8601.
format: date-time
links:
type: object
additionalProperties:
type: string
description: >-
Un mapa de nombres de enlaces a URI asociados que proporcionan
información adicional sobre la operación por lotes.
requestedAt:
type: string
description: >-
La fecha y la hora en que se solicitó la operación por lotes, en
formato ISO 8601.
format: date-time
results:
type: array
description: >-
Una matriz que contiene los resultados de la operación por lotes,
donde cada elemento representa una respuesta de suscripción
individual.
items:
$ref: '#/components/schemas/SubscriptionResponse'
startedAt:
type: string
description: >-
La fecha y la hora en que comenzó la operación por lotes, en formato
ISO 8601.
format: date-time
status:
type: string
description: >-
El estado actual de la operación por lotes. Los valores válidos son
"PENDING", "PROCESSING", "CANCELED" y "COMPLETE".
enum:
- CANCELED
- COMPLETE
- PENDING
- PROCESSING
BatchResponseSubscriptionResponseWithErrors:
required:
- completedAt
- results
- startedAt
- status
type: object
properties:
completedAt:
type: string
description: >-
La fecha y hora en que se completó el procesamiento por lotes, en
formato ISO 8601.
format: date-time
errors:
type: array
description: >-
Un conjunto de objetos StandardError que detalla los errores que se
produjeron durante el procesamiento por lotes.
items:
$ref: '#/components/schemas/StandardError'
links:
type: object
additionalProperties:
type: string
description: >-
Un mapa de nombres de enlaces a URI asociados que proporciona
recursos o documentación adicionales relacionados con la operación
por lotes.
numErrors:
type: integer
description: >-
El número total de errores encontrados durante la operación por
lotes.
format: int32
requestedAt:
type: string
description: >-
La fecha y hora en que se hizo inicialmente la solicitud por lotes,
en formato ISO 8601.
format: date-time
results:
type: array
description: >-
Un conjunto de objetos SubscriptionResponse que representan los
resultados de cada actualización de suscripción procesada en el
lote.
items:
$ref: '#/components/schemas/SubscriptionResponse'
startedAt:
type: string
description: >-
La fecha y hora en que comenzó el procesamiento por lotes, en
formato ISO 8601.
format: date-time
status:
type: string
description: >-
El estado actual de la operación por lotes. Los valores válidos son
"PENDING", "PROCESSING", "CANCELED" y "COMPLETE".
enum:
- CANCELED
- COMPLETE
- PENDING
- PROCESSING
SubscriptionBatchUpdateRequest:
required:
- active
- id
type: object
properties:
active:
type: boolean
description: Un booleano que indica si la suscripción está activa.
id:
type: integer
description: El identificador único de la suscripción. Es un número entero.
format: int32
SubscriptionResponse:
required:
- active
- createdAt
- eventType
- id
type: object
properties:
active:
type: boolean
description: Un booleano que indica si la suscripción está activa actualmente.
createdAt:
type: string
description: La fecha y hora en que se creó la suscripción, en formato ISO 8601.
format: date-time
eventType:
type: string
description: >-
El tipo de evento que desencadena la suscripción. Los valores
válidos incluyen varios cambios de propiedades, creaciones,
eliminaciones, combinaciones, restauraciones y cambios de asociación
de diferentes objetos de HubSpot.
enum:
- 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
eventTypeName:
type: string
description: El nombre del tipo de evento para la suscripción.
id:
type: string
description: >-
El identificador único de la suscripción. Es un número entero con
formato int64.
objectTypeId:
type: string
description: >-
El identificador del tipo de objeto asociado a la suscripción. Es
una cadena.
propertyName:
type: string
description: >-
El nombre de la propiedad asociada al evento de suscripción, si
aplica.
updatedAt:
type: string
description: >-
La fecha y hora en que la suscripción se actualizó por última vez,
en formato ISO 8601.
format: date-time
StandardError:
required:
- category
- context
- errors
- links
- message
- status
type: object
properties:
category:
type: string
description: Una cadena que indica la categoría del error.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Un objeto que contiene contexto adicional sobre la condición del
error, en el que cada propiedad es un conjunto de cadenas.
errors:
type: array
description: >-
Un conjunto de objetos ErrorDetail que proporciona más información
sobre el error.
items:
$ref: '#/components/schemas/ErrorDetail'
id:
type: string
description: Una cadena que identifica de forma única la instancia del error.
links:
type: object
additionalProperties:
type: string
description: >-
Un objeto que asigna nombres de enlaces a URI asociados que
contienen documentación sobre el error o los pasos de solución
recomendados.
message:
type: string
description: >-
Una cadena que contiene un mensaje comprensible para los humanos que
describe el error.
status:
type: string
description: Una cadena que representa el estado del error.
subCategory:
type: object
properties: {}
description: >-
Un objeto que proporciona una categorización más específica del
error.
description: Ye olde error
Error:
required:
- category
- correlationId
- message
type: object
properties:
category:
type: string
description: La categoría del error
context:
type: object
additionalProperties:
type: array
items:
type: string
description: Contexto de la condición de error
example: >-
{invalidPropertyName=[propertyValue], missingScopes=[scope1,
scope2]}
correlationId:
type: string
description: >-
Un identificador único para la solicitud. Incluye este valor con
cualquier informe de error o ticket de asistencia.
format: uuid
example: aeb5f871-7f07-4993-9211-075dc63e7cbf
errors:
type: array
description: información adicional acerca del error
items:
$ref: '#/components/schemas/ErrorDetail'
links:
type: object
additionalProperties:
type: string
description: >-
Un mapa de nombres de enlaces a las URI asociadas que contienen
documentación sobre el error o los pasos recomendados para
solucionarlo
message:
type: string
description: >-
Un mensaje legible en el que se describa el error y los pasos para
solucionarlo, si procede
example: An error occurred
subCategory:
type: string
description: >-
Una categoría específica que contiene detalles más concretos acerca
del error
description: >-
Representa una respuesta de error que devuelve la API cuando una
operación falla. Este componente se usa en varios puntos de terminación
para dar información detallada sobre el error que se encontró.
example:
message: Invalid input (details will vary based on the error)
correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
category: VALIDATION_ERROR
links:
knowledge-base: https://www.hubspot.com/products/service/knowledge-base
ErrorDetail:
required:
- message
type: object
properties:
code:
type: string
description: El código de estado asociado al detalle del error
context:
type: object
additionalProperties:
type: array
items:
type: string
description: Contexto de la condición de error
example: '{missingScopes=[scope1, scope2]}'
in:
type: string
description: El nombre del campo o parámetro en el que se encontró el error.
message:
type: string
description: >-
Un mensaje legible en el que se describa el error y los pasos para
solucionarlo, si procede
subCategory:
type: string
description: >-
Una categoría específica que contiene detalles más concretos acerca
del error
description: >-
Representa información detallada sobre un error que ocurrió en la API.
Este componente se usa para dar contexto adicional y detalles
específicos sobre los errores, normalmente como parte de una respuesta
de error.
responses:
Error:
description: An error occurred.
content:
'*/*':
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://app.hubspot.com/oauth/authorize
tokenUrl: https://api.hubapi.com/oauth/v1/token
scopes:
developers-read: ''
developers-write: ''
private-apps-read: ''
private-apps-write: ''
webhooks-journal-data-access: ''
webhooks-journal-snapshot-management: ''
webhooks-journal-subscription-management: ''
webhooks-journal-subscription-read: ''
````
{product.name} -
{product.level}
)}