Skip to main content
Ten en cuenta: las API de esta sección utilizan el versionado numérico anterior (v1, v2, v3, v4) y serán descontinuadas en una versión futura. Para nuevas integraciones, utiliza las API 2026-03. Migrar a la ruta de versión basada en fechas (por ejemplo, /crm/objects/2026-03/contacts) protege tu integración a largo plazo a medida que HubSpot transiciona a versiones basadas en fechas.
La referencia de API legacy abarca los endpoints de HubSpot con versiones numéricas anteriores. Estas API abarcan cuatro niveles de versión principales — v4, v3, v2 y v1 — cada uno representando diferentes generaciones de la plataforma HubSpot. Los endpoints siguen el patrón:
Por ejemplo, para recuperar un contacto con la API CRM Objects v3:

​
API por versión

​
v4

Los endpoints v4 son las API más recientes antes del versionado basado en fechas e incluyen Associations y Automation Actions.
  • CRM Associations v4: (/crm/v4/associations/, /crm/v4/objects/{objectType}/{objectId}/associations/) crear, leer y eliminar asociaciones entre registros; configurar etiquetas y tipos de asociación
  • Automation Workflow Actions v4: (/automation/v4/actions/) definir acciones de workflow personalizadas con campos de entrada, callbacks de ejecución y definiciones de acciones

​
v3

La mayoría de las API principales de la plataforma HubSpot se encuentran en v3. Incluyen los endpoints principales de CRM, CMS, automatización y marketing.
  • CRM Objects v3: (/crm/v3/objects/{objectType}) operaciones CRUD y por lotes para contactos, empresas, negocios, tickets y todos los demás objetos CRM estándar y personalizados; incluye búsqueda, fusión, eliminación GDPR y gestión de esquemas
  • CRM Associations v3: (/crm/v3/associations/{fromObjectType}/{toObjectType}/batch/) lectura, creación y eliminación por lotes de asociaciones
  • CRM Properties v3: (/crm/v3/properties/{objectType}) crear y gestionar propiedades de objetos y grupos de propiedades
  • CRM Pipelines v3: (/crm/v3/pipelines/{objectType}) gestionar pipelines y etapas de negocios y tickets
  • CRM Imports/Exports v3: (/crm/v3/imports/, /crm/v3/exports/) importación y exportación masiva de registros CRM
  • CRM Lists v3: (/crm/v3/lists/) crear y gestionar listas de contactos y empresas
  • CRM Extensions v3: (/crm/v3/extensions/) extensiones de llamadas e integraciones de videoconferencia
  • Automation Workflows v3: (/automation/v3/workflows/) crear, recuperar y eliminar workflows de HubSpot
  • Conversations v3: (/conversations/v3/) gestionar bandejas de entrada, hilos, mensajes y canales personalizados
  • CMS v3: (/cms/v3/) publicaciones de blog, páginas, HubDB, código fuente, dominios, asignaciones de URL y redirecciones
  • Marketing Events v3: (/marketing/v3/marketing-events/) crear y gestionar registros de eventos de marketing
  • Communication Preferences v3: (/communication-preferences/v3/) gestionar definiciones y estados de suscripción
  • Webhooks v3: (/webhooks/v3/) configurar suscripciones y ajustes de webhooks
  • Events v3: (/events/v3/) enviar y gestionar eventos de comportamiento personalizados
  • Files v3: (/files/v3/) subir, gestionar y recuperar archivos y carpetas

​
v2

Las API v2 son versiones anteriores de los endpoints CRM y CMS, muchas de las cuales han sido reemplazadas por versiones v3.
  • CRM Properties v2: (/properties/v2/{objectType}/properties) gestionar propiedades y grupos de propiedades de contactos, empresas y negocios
  • CRM Companies v2: (/companies/v2/companies/) crear, leer, actualizar y eliminar registros de empresas
  • CRM Deals v2: (se superpone con v1; algunos endpoints de actualización por lotes a nivel de negocio)
  • CMS Blog Posts v2: (/content/api/v2/blog-posts/) gestionar borradores, versiones y publicaciones de blog
  • CMS Pages v2: (/content/api/v2/pages/) gestionar páginas web y landing pages
  • CMS Blog Settings v2: (/content/api/v2/blogs/) leer configuración de blog
  • CMS Site Search v2: (/site-search/v2/) buscar contenido web indexado y recuperar propiedades indexadas
  • CMS Layouts and Templates v2: (/content/api/v2/) gestionar plantillas y diseños del CMS
  • Automation Workflows v2: (/automation/v2/workflows/) gestionar la inscripción de contactos en workflows
  • Marketing Forms v2: (/forms/v2/forms/) crear, leer, actualizar y eliminar formularios de HubSpot; recuperar definiciones de campos

​
v1

Las API v1 son la generación más antigua e incluyen principalmente endpoints legacy para contactos, negocios, engagements y cuentas.
  • CRM Contacts v1: (/contacts/v1/) crear, leer, actualizar y eliminar contactos; gestionar direcciones de email secundarias; operaciones por lotes; búsqueda
  • CRM Deals v1: (/deals/v1/deal/) crear, leer, actualizar y eliminar registros de negocios; actualizaciones asíncronas por lotes
  • CRM Line Items v1: (/crm-objects/v1/objects/line-items/) gestionar registros de partidas y operaciones por lotes
  • CRM Products v1: (/crm-objects/v1/objects/products/) gestionar registros de productos
  • CRM Tickets v1: (/crm-objects/v1/objects/tickets/) gestionar registros de tickets
  • CRM Owners v2: (/owners/v2/owners/) recuperar propietarios del CRM
  • CRM Pipelines v1: (/crm-pipelines/v1/pipelines/{objectType}) gestionar pipelines y etapas
  • CRM Lists v1: (/contacts/v1/lists/) crear y gestionar listas de contactos estáticas y dinámicas
  • CRM Associations v1: (/crm-associations/v1/associations/) crear, leer y eliminar asociaciones entre objetos
  • CRM Engagements v1: (/engagements/v1/engagements/) crear y gestionar llamadas, emails, reuniones, notas y tareas como registros de engagement
  • CRM Extensions v1: (/extensions/sales-objects/v1/) configurar tipos de objetos para tarjetas CRM
  • Account Info v1: (/integrations/v1/me) recuperar información básica de la cuenta autenticada
  • Communication Preferences v1: (/email/public/v1/subscriptions/) leer y actualizar el estado de suscripción de email
  • Marketing Forms v1: (/form-integrations/v1/) recuperar envíos de formularios y URLs de archivos firmadas
  • Marketing Transactional Send v1: (/email/public/v1/singleEmail/send) enviar emails transaccionales individuales; gestionar tokens de API SMTP
  • CMS Domains v1: (/cms/v1/domains/) listar y recuperar configuraciones de dominios CMS
  • Reporting v2: (/analytics/v2/reports/) recuperar datos analíticos de contenido y eventos
Última modificación el 3 de abril de 2026