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: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.
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