{scope}
### Formato de los datos de importRequest
En la solicitud, define los detalles del archivo de importación, incluida la asignación de las columnas de la hoja de cálculo a los datos de HubSpot. La solicitud debe incluir los siguientes campos:
* **name**: el nombre de la importación. En HubSpot, este es el nombre que aparece en la [herramienta de importaciones](https://knowledge.hubspot.com/es/import-and-export/view-and-analyze-previous-imports), así como el nombre al que puedes hacer referencia en otras herramientas, como las listas.
* **importOperations**: es un campo opcional utilizado para indicar si la importación debe [crear y actualizar, solo crear o solo actualizar registros](https://knowledge.hubspot.com/es/import-and-export/import-objects#choose-how-to-import) para un determinado objeto o actividad. Incluye `objectTypeId` para el objeto o actividad y si quieres `UPSERT` (crear y actualizar), `CREATE` o `UPDATE` registros. Por ejemplo, el campo se vería así en la solicitud: `"importOperations": {"0-1": "CREATE"}`. Si no incluyes este campo, el valor predeterminado para la importación es `UPSERT`.
* **dateFormat**: es el formato para las fechas incluidas en el archivo. De forma predeterminada, esto se estructura por `MONTH_DAY_YEAR`, pero también puedes usar `DAY_MONTH_YEAR` o `YEAR_MONTH_DAY`.
* **marketableContactImport**: es un campo opcional para indicar el [estado de marketing](https://knowledge.hubspot.com/es/records/marketing-contacts) de los contactos en tu archivo de importación. Este campo solo se usa cuando se importan contactos a cuentas que tienen [acceso a los contactos de marketing](https://knowledge.hubspot.com/es/records/marketing-contacts#check-your-access-to-marketing-contacts). Para establecer los contactos como de marketing en el archivo, usa el valor `true`. Para establecer los contactos como no de marketing en el archivo, usa el valor `false`.
* **createContactListFromImport**: es un campo opcional para [crear una lista estática de los contactos](https://knowledge.hubspot.com/es/import-and-export/import-objects#create-list-from-import) en la importación. Para crear una lista a partir del archivo, usa el valor `true`.
* **files**: es una matriz que contiene la información del archivo de importación.
* **fileName**: el nombre del archivo de importación.
* **fileFormat:** el formato del archivo de importación. Para los archivos CSV, usa el valor `CSV`. Para los archivos de Excel, usa el valor `SPREADSHEET`.
* **fileImportPage**: contiene la matriz `columnMappings` que es necesaria para asignar los datos de tu archivo de importación a los datos de HubSpot. Más información sobre la asignación de columnas a continuación.
### Asignar las columnas del archivo a las propiedades de HubSpot
Dentro de la matriz `columnMappings`, incluye una entrada para cada título en la columna del archivo de importación, que coincida con el orden en la hoja de cálculo.
Para cada columna, incluye los siguientes campos:
* **columnObjectTypeId:** el nombre o el valor `objectTypeId` del objeto o la actividad a la que pertenecen los datos. Consulta [este artículo](/guides/crm/understanding-the-crm#object-type-id) para obtener una lista completa de los valores `objectTypeId`.
* **columnName:** el nombre del título de la columna. Debe coincidir exactamente con el nombre del título de la columna en el archivo.
* **propertyName:** el nombre interno de la propiedad de HubSpot a la que se le asignarán los datos. Para la columna común en las [importaciones de varios archivos](#import-multiple-files), `propertyName` debe ser `null` cuando se utilice el campo `toColumnObjectTypeId`.
* **columnType:** se utiliza para especificar que una columna contiene una [propiedad de identificador única](https://knowledge.hubspot.com/es/import-and-export/understand-the-import-tool#unique-identifiers). Dependiendo de la propiedad y el propósito de la importación, puedes utilizar uno de los siguientes valores:
* **HUBSPOT\_OBJECT\_ID:** el ID de un registro. Por ejemplo, el archivo de importación de contactos puede contener una columna *ID de registro* que tenga el ID de la empresa con la que deseas asociar los contactos.
* **HUBSPOT\_ALTERNATE\_ID:** un identificador único distinto del ID de registro. Por ejemplo, el archivo de importación de contactos puede contener una columna de *Correo electrónico* que tenga las direcciones de correo electrónico de los contactos.
* **FLEXIBLE\_ASSOCIATION\_LABEL**: incluye este tipo de columna para indicar que la columna contiene etiquetas de asociación.
* **ASSOCIATION\_KEYS**: utiliza este tipo de columna únicamente para las importaciones que asocien el mismo objeto, e inclúyelo para especificar el identificador único de los registros de objeto que quieres asociar. Por ejemplo, en tu solicitud de importación de una asociación de contactos, la columna *Contacto asociado \[correo electrónico o ID de registro]* debe tener un `columnType` de `ASSOCIATION_KEYS`. Más información sobre cómo [configurar el archivo de importación para una misma importación de asociación de objetos](https://knowledge.hubspot.com/es/import-and-export/set-up-your-import-file#same-object-association-imports).
* **toColumnObjectTypeId**: se utiliza para importaciones que incluyan [varios archivos](#import-multiple-files) o varios objetos, este campo indica el nombre o `objectTypeId` del objeto al que pertenece la propiedad de la [columna común](https://knowledge.hubspot.com/es/import-and-export/set-up-your-import-file#import-associations-in-two-files) o la etiqueta de asociación. Debes incluir este campo para la propiedad de columna común en el archivo del objeto al que no pertenece la propiedad. Por ejemplo, si estás asociando contactos y empresas en dos archivos usando la propiedad de contacto *Correo electrónico* como columna común, incluye el `toColumnObjectTypeId` para la columna *Correo electrónico* en el archivo de empresas.
* **foreignKeyType**: se utiliza solo para [importaciones de varios archivos](#import-multiple-files), es el tipo de asociación que debe usar la columna común, especificado por `associationTypeId` y `associationCategory`. Debes incluir este campo para la propiedad de columna común en el archivo del objeto al que no pertenece la propiedad. Por ejemplo, si estás asociando contactos y empresas en dos archivos con la propiedad de contacto *Correo electrónico* como columna común, incluye el `foreignKeyType` para la columna *Correo electrónico* en el archivo de empresas.
* **associationIdentifierColumn**: se utiliza solo para [importaciones de varios archivos](#import-multiple-files), este campo indica la propiedad utilizada en la columna común para asociar a los registros. Incluye este campo para la propiedad de columna común en el archivo del objeto al que pertenece la propiedad. Por ejemplo, si estás asociando contactos y empresas en dos archivos con la propiedad de contacto *Correo electrónico* como columna común, establece la `associationIdentifierColumn` en `true` para la columna *Correo electrónico* en el archivo de contactos.
## Importar un archivo con un objeto
A continuación, incluimos un ejemplo del cuerpo de la solicitud para importar un archivo y crear contactos: