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

# Referencia de API legacy

> Documentación de referencia para las API de HubSpot con versiones numéricas anteriores (v1–v4).

<Warning>
  **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](/api-reference/latest/overview). 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.
</Warning>

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:

```text theme={null}
/api-name/v{version}/resource
```

Por ejemplo, para recuperar un contacto con la API CRM Objects v3:

```bash theme={null}
GET /crm/v3/objects/contacts/{contactId}
```

## 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