Última actualización: 25 de junio de 2025
Disponible con cualquiera de las siguientes suscripciones, a no ser que se indique de otro modo:
Antes de importar datos a HubSpot, revisa los siguientes límites y requisitos. También puedes acceder a archivos de muestra o generar archivos de ejemplo para empezar.
Para obtener más información sobre la herramienta de importación, consulta este artículo. Si tu archivo está listo, aprende a importarlo.
Requisitos técnicos y límites
Todos los archivos que se importan a HubSpot deben cumplir estos requisitos:- Ser un archivo .csv, .xlsx o .xls.
- Tener solo una hoja.
- Incluir una fila de encabezados en la que cada encabezado de columna corresponda a una propiedad de HubSpot. Los encabezados de las columnas pueden organizarse en cualquier orden sin que ello afecte a la importación. Puedes confirmar si ya existe una propiedad predeterminada que coincida con tu cabecera o crear una propiedad personalizada antes de importar. Más información sobre los requisitos de propiedades.
- Contener menos de 1000 columnas.
- Tener codificación UTF-8 si se incluyen caracteres de idiomas extranjeros.
- Si vas a importar un archivo Excel, el archivo debe:
- Contener datos que permanecen por debajo de los límites máximos de hojas de cálculo y libros de Excel.
- Contener celdas en formato numérico al importar propiedades del selector de fecha y hora.
Existen límites técnicos adicionales para la herramienta de importación en función de tu suscripción a HubSpot. Estos límites incluyen los límites de tamaño y filas de un archivo de importación, así como el número de archivos y filas que puede importar al día.
- Si sólo utilizas las herramientas gratuitas de HubSpot o Smart CRM de Pro o Enterprise , puedes hacerlo:
- Importar archivos de hasta 20 MB.
- Realizar hasta 50 importaciones al día.
- Importar hasta 500.000 filas al día. Si importas un archivo con más de 500.000 filas, tardará varios días en completarse.
- Si tu cuenta tiene una suscripción Starter, Pro o Enterprise, puedes:
- Importar archivos de hasta 512 MB.
- Realizar hasta 500 importaciones al día.
- Importar hasta 10.000.000 de filas al día, con un límite de 1.048.576 filas por archivo. Al usar la API de importaciones, puedes importar hasta 80.000.000 filas por día.
Estos límites se aplican a un período de 24 horas y no se restablecen en un momento específico del día. Obtén más información sobre tu suscripción de HubSpot y sus limitaciones.
Formato de los valores
Para cada fila de tu archivo de importación, puedes agregar valores para las columnas de propiedades. El formato de un valor depende del tipo de campo de propiedad y de la meta de la importación.
Formatear valores en función del tipo de campo de propiedad
En función del tipo de campo de Propiedad, existen requisitos de formato específicos:
| Tipos de campo | Requisitos |
| Selector de fechas Selector de fecha y hora |
Los meses pueden ser un número, tres letras o un nombre completo (10, OCT, Oct, OCTUBRE, octubre), los años pueden tener dos dígitos o cuatro (2023, 23) y los separadores pueden ser una barra, un guion o un punto (28/10/2023, 28-10-2023, 28.10.2023). Los formatos de fecha válidos son día mes año (por ejemplo, 28/10/2023), mes día año (por ejemplo, 10-28-23) o año mes día (por ejemplo, 2023.OCT.28). Si ha ajustado reglas de validación, los valores importados deben seguir las reglas o no se importarán. |
| Selector de fecha y hora |
Las marcas de tiempo se pueden agregar como hh:mm (28/10/2020 14:30) en todos los tipos de archivo o como una marca de tiempo UNIX en milisegundos en archivos CSV o un archivo Excel con celdas en formato de número de texto. Si no se incluye una marca de tiempo, la hora se establece por opción predeterminada en la medianoche. |
| Duración: |
Para las propiedades que contienen una duración, como la propiedad Duración de llamada, tus valores deben formatearse como una marca de tiempo UNIX en milisegundos. Consulta más información sobre cómo dar formato a los valores de las marcas de tiempo y cómo convertir una fecha a formato UNIX. |
| Enumeración |
Los valores de su archivo de importación deben coincidir con la etiqueta o con el valor interno de las opciones definidas de la propiedad. Para las propiedades de enumeración predeterminadas de HubSpot (por ejemplo, Etapa del ciclo de vida, Industria), los valores deben coincidir con el valor interno o la etiqueta en inglés. |
| Archivo |
Para agregar archivos existentes a una propiedad de archivo, incluye el ID de archivo como valor. Puedes encontrar el ID de un archivo en la sección General de los detalles de un archivo. |
| Múltiples casillas de comprobación |
Para importar varios valores, agrega un punto y coma entre cada valor sin espacios (valor 1;valor 2). Estas opciones de propiedad deben crearse antes de la importación. Para agregar o anexar valores, agrega un punto y coma antes del primer valor (;valor 3;valor 4). Esto agregará el valor en lugar de sobrescribir el valor existente de la propiedad. |
| Número |
Formatea el valor en función del tipo de propiedad numérica creada:
|
| Casilla de comprobación única |
Crea una columna para el campo de casilla de verificación único y establece el valor de cada línea Verdadero o Sí para mostrarlo como Sí o marcado en HubSpot o Falso o No para mostrarlo como No o no marcado en HubSpot. |
| Propiedades de texto |
La propiedad elemento de pedido Término debe agregarse en los formatos de período ISO-8601 de PnYnMnD o PnW. Por ejemplo, P12M o P24M para plazos anuales. Si se deja en blanco, se establecerán los plazos predeterminados. |
| Texto |
Si ha ajustado reglas de validación, los valores importados deben seguir las reglas o no se importarán. |
| Usuario (Propietario) |
Para asignar un propietario a un registro o actividad durante la importación:
|
Otros correos electrónicos de contacto o dominios de empresa
Si importa contactos con más de una dirección de correo electrónico, incluya una columna Direcciones de correo electrónico adicionales con sus correos electrónicos secundarios. Si vas a importar empresas con más de un nombre de dominio, incluye una columna Dominios adicionales con sus dominios secundarios. Para incluir varios correos electrónicos o dominios en una celda, separa los valores con punto y coma (por ejemplo, email@email.com; emailtwo@email.com).
Si estás importando para crear contactos o empresas, no puedes establecer el Correo electrónico de un nuevo contacto o el Dominio de empresa de una nueva empresa en un correo electrónico o dominio que sea un correo electrónico/dominio adicional existente para otro registro.
Celdas en blanco
La herramienta de importación ignora las celdas en blanco en una hoja de cálculo, así que cuando importes nuevos datos de propiedades, deja las celdas en blanco para los registros sin un valor para la propiedad. Si un registro existente ya tiene un valor para la propiedad dentro de HubSpot, las celdas en blanco no borrarán el valor de la propiedad existente. Para borrar valores de propiedades existentes en bloque, puede editar manualmente los valores o utilizar la acción de workflowEditar registros .Colaboradores de negocios
Si estás agregando colaboradores a un negocio mediante importación, incluye un encabezado Colaborador de negocio. En cada celda, debes incluir dos o más usuarios, separados por punto y coma (por ejemplo, user1@example.com;user2@example.com).Plazos y frecuencias de facturación de los productos
Si quieres importar un valor de propiedad Plazo, el formato del valor de la columna Plazo debe ser un número en meses (por ejemplo, 10 para 10 meses), como PXM, donde X es el número de meses (por ejemplo, P6M para un plazo de 6 meses) o PXY, donde X es el número de años (por ejemplo, P1Y para un plazo de 1 año).
Para importar productos con el valor de propiedad Frecuencia de facturación, usa mensualmente, anualmente o trimestralmente si el producto tiene un tipo de precio recurrente. Deja la celda en blanco si el producto tiene un precio único.
Propiedades obligatorias
Dependiendo de los objetos o actividades que estés importando, las siguientes propiedades son necesarias para crear registros, y deben incluirse como encabezados de columna en tus archivos. Si estás actualizando registros, debes incluir un identificador único (por ejemplo, ID de registro, Correo electrónico, Nombre de dominio de la empresa).
Aunque no es obligatorio, puedes importar propiedades adicionales para cada objeto, incluyendo propiedades personalizadas y predeterminadas. Consulta las propiedades de forma predeterminada para contactos, empresas, negocios, tickets, llamadas, correos electrónicos, reuniones, notas y tareas. También puedes ver todas las propiedades y sus valores en configuración de las propiedades.
- Contactos: al menos uno de Nombre, Apellido o Correo electrónico.
- Empresas: al menos uno de los dominios Nombre o Empresa.
Nota: la propiedad de empresa sólo acepta valores hasta el dominio de nivel superior (por ejemplo, .com, .edu). Los valores con cadenas a continuación (por ejemplo, .edu/home) se eliminarán automáticamente al realizar la importación.
- Negocios: si estás creando nuevos negocios, Nombre del negocio, Pipeline y Etapa del negocio.
- Tickets: si estás creando nuevos tickets, Nombre del ticket, Pipeline y Estado del ticket.
- Citas: Inicio de la cita. El inicio de la cita debe formatearse como una propiedad de fecha-hora.
- Cursos: Nombre del curso.
- Listados: Nombre.
- Servicios: Nombre, Pipeline y Etapa de pipeline.
- Productos: si estás creando productos, Precio unitario y Nombre.
- Pedidos: Nombre, Pipeline y Etapa de pipeline.
- Carritos: Nombre.
- Elementos de pedido: Nombre, Cantidad y Precio, así como el ID de registro o el Nombre del negocio asociados al negocio en cuestión. Si también vas a asociar elementos de pedido específicos con productos concretos, incluye el ID de producto, que se asignará como una propiedad de elemento de pedido durante la importación.
Nota: Al importar elementos de pedido con negocios, la importación no actualizará la cantidad del negocio. Para actualizar la cantidad del negocio asociada, puedes editar manualmente los elementos de pedido o asociar los elementos de pedido a un negocio en HubSpot.
- Llamadas: Notas de llamada. Al importar nuevas convocatorias, también se recomienda incluir Fecha de actividad.
- Correos electrónicos: Cuerpo del correo y Dirección del correo electrónico.
- Reuniones: Descripción de la reunión, Hora de inicio de la reunión y Hora de finalización de la reunión. Al importar nuevas reuniones, también se recomienda incluir Fecha de la actividad. Los valores de hora de inicio, hora de fin y fecha de actividad deben formatearse como propiedades de fecha-hora.
- Notas: Cuerpo de la nota.
- Tareas: Título de la tarea y Fecha de vencimiento. La fecha de vencimiento debe formatearse como una propiedad fecha-hora.
Nota: aunque no es obligatorio, se recomienda incluir Fecha de la actividad al importar nuevas actividades para especificar la fecha y hora en que se produjo una actividad. Si no incluyes esta propiedad, los valores de Fecha de actividad se establecen automáticamente en la fecha y hora de la importación.
Requisitos para actualizar los registros existentes o evitar duplicados
Para actualizar registros existentes y evitar registros duplicados, los archivos deben incluir una propiedad de identificador único por cada objeto. Para todos los objetos, puede exportar los registros existentes y utilizar el ID del registro como identificador único, o utilizar una propiedad personalizada que requiera valores únicos. Para los contactos, también puede utilizar Correo electrónico. Para empresas, también puedes usar el Nombre de dominio de la empresa.
Si importas varios objetos e incluyes el ID de registro, te recomendamos que diferencies los encabezados de las columnas del archivo de forma que el ID coincida con el objeto correcto (por ejemplo, que una columna se llame ID de registro - Contactos y otra se llame ID de registro - Empresas).
Nota: el siguiente comportamiento se aplica si en el archivo se incluye el Correo electrónico o el Nombre de dominio de la empresa:
- Si utilizas una propiedad de valor único personalizada para desduplicar los contactos, la propiedad Correo electrónico seguirá necesitando valores únicos.
- Si estás utilizando una propiedad de valor único personalizada para desduplicar empresas, la propiedad Nombre de dominio de la empresa no requerirá valores únicos. Esto significa que puedes importar dominios de empresa duplicados. Si no deseas tener varias empresas con el mismo dominio, debes eliminar los dominios duplicados de tu archivo antes de importar, o utilizar Nombre de dominio de la empresa como identificador único en su lugar.
- Puedes utilizar un correo electrónico secundario como identificador único para los contactos existentes que tengan una dirección de correo electrónico secundaria en HubSpot. Si usas un correo electrónico secundario y no incluyes la columna ID de registro en el archivo, el correo electrónico secundario no reemplazará el correo electrónico principal. Sin embargo, si incluyes tanto el correo electrónico secundario como el ID de registro como columnas en el archivo, el correo electrónico secundario reemplazará el correo electrónico principal.
Requisitos para asociar registros
Importar asociaciones en un solo archivo
En un archivo, puede asociar dos o más registros por fila. Incluye información sobre los registros y/o actividades asociados en la misma fila e incluye un identificador único para cada objeto. Para asociar un registro con varios registros de otro objeto, incluye el identificador único del registro en varias filas por cada registro que quieras asociar.
En el ejemplo de abajo, Luke Danes es gerente de Luke's Diner, pero contratista de The Dragonfly Inn. Para asociarlo con ambas empresas, tendrías que incluir por cada empresa dos filas para Luke Danes con las columnas Correo electrónico (o ID de registro) y Nombre de dominio de la empresa (o ID de registro).
Nota: si no incluyes identificadores únicos (por ejemplo, Correo electrónico, Nombre de dominio de la empresa, o ID de registro), la importación creará registros duplicados en lugar de asociar cada uno al mismo registro.
Si estás importando las mismas asociaciones de objetos, existen requisitos adicionales.
Importar asociaciones en dos archivos
Para asociar registros de dos objetos en dos archivos, utiliza una columna común para conectar los registros de cada archivo. Si necesitas más ayuda para importar y asociar registros, consulta los archivos de ejemplo que se incluyen más abajo.
Mismas asociaciones de objetos
Puedes importar un archivo para asociar registros del mismo objeto en bloque. Durante el proceso de importación, tendrás que seleccionar una casilla de verificación para incluir las mismas asociaciones de objetos.
Cuando configures tu archivo, incluye información sobre los registros asociados en la misma fila e incluye un identificador único para cada registro. Los siguientes requisitos adicionales son específicos de las importaciones de objetos iguales:
- Al menos un registro en un par de registros ya debe existir en HubSpot antes de la importación. Por ejemplo, puedes importar un contacto nuevo y asociarlo a un contacto existente, pero no puedes importar para crear y asociar dos contactos nuevos.
- Al asociar contactos/empresas existentes, solo puedes utilizar el correo electrónico/dominio de la empresa principal como identificador único. Los correos electrónicos o dominios secundarios no son admitidos.
- Si vas a asociar varios registros a uno solo, separa los valores del identificador único de los registros con un punto y coma en la misma celda (por ejemplo, luke@lukesdiner.com; rory@yale.edu; sookie@dragonfly.com).
En el archivo de ejemplo siguiente, Rory y Jackson son nuevos contactos a los que se asocian etiquetas únicas a contactos existentes, utilizando sus valores de Correo electrónico como identificador único. Sookie es un contacto existente que se asocia a dos contactos existentes con la misma etiqueta. En la primera fila, la etiqueta de asociación forma parte de un par de etiquetas, lo que significa que, una vez completada la importación, el registro asociado tendrá la etiqueta Principal y Rory tendrá la etiqueta emparejada, Secundaria.
Asociaciones principales-secundarias
Para crear asociaciones de empresas secundarias a través de la importación, obtenga más información sobre la importación de empresas secundarias.
Etiquetas de asociación personalizadas (soloPro y Enterprise)
Para importar etiquetas de asociación, incluya una columna Etiqueta de asociación . Esta columna solo debe agregarse si deseas agregar etiquetas para describir las asociaciones. Si no necesitas etiquetar asociaciones, la columna no es necesaria.
- Debes crear las etiquetas de asociación en HubSpot antes de importar.
- Para establecer una asociación de empresa como primaria, incluye el valor Primaria en la columna Etiqueta de asociación para esa fila.
- Para definir varias etiquetas de forma que describan la relación entre dos registros, puedes incluir varios valores de etiquetas de asociación en una celda, separados por punto y coma (por ejemplo, Mánager; Contacto de facturación).
- Si vas a importar etiquetas de asociación en una importación múltiple de archivos , debes incluir en el mismo archivo la etiqueta de asociación columna y un identificador único para el objeto que vas a asociar.
- Si vas a importar etiquetas emparejadas:
- Para las asociaciones multiobjeto, incluye solo una de las etiquetas en la columna Etiqueta de asociación. Las etiquetas se asignarán al objeto correcto durante el proceso de importación.
- Para las mismas asociaciones de objetos, el registro de la columna Asociado [identificador único ] recibirá la etiqueta añadida en el proceso de importación o incluida en la columna de etiquetas del archivo. El otro registro de la fila recibirá la otra etiqueta del par.
Archivos de ejemplo
Al principio del proceso de importación, puedes generar un archivo de ejemplo con las propiedades necesarias para los objetos y actividades seleccionados. Si deseas ver más ejemplos con propiedades adicionales, consulta este artículo con archivos de ejemplo.
