Saltar al contenido principal
POST
/
crm
/
v3
/
imports
Iniciar una nueva importación
curl --request POST \
  --url https://api.hubapi.com/crm/v3/imports/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form files='@example-file' \
  --form 'importRequest=<string>'
{
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "mappedObjectTypeIds": [
    "<string>"
  ],
  "metadata": {
    "counters": {},
    "fileIds": [
      "<string>"
    ],
    "objectLists": [
      {
        "listId": "<string>",
        "objectType": "<string>"
      }
    ]
  },
  "optOutImport": true,
  "state": "CANCELED",
  "updatedAt": "2023-11-07T05:31:56Z",
  "importName": "<string>",
  "importRequestJson": {},
  "importSource": "API",
  "importTemplate": {
    "templateId": 123,
    "templateType": "admin_defined"
  }
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito

Autorizaciones

Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Cuerpo

multipart/form-data
files
file
importRequest
string

Respuesta

successful operation

createdAt
string<date-time>
requerido

La marca de tiempo en la que se creó el objeto, en formato ISO 8601.

id
string
requerido

El identificador único de esta importación.

mappedObjectTypeIds
string[]
requerido
metadata
object
requerido
optOutImport
boolean
requerido

Si la importación es o no es una lista de personas que no califican para recibir correos.

state
enum<string>
requerido

El estado de la importación.

Opciones disponibles:
CANCELED,
DEFERRED,
DONE,
FAILED,
PROCESSING,
REVERTED,
STARTED
updatedAt
string<date-time>
requerido

La marca de tiempo de cuando se actualizó por última vez el registro de importación, formateada como un instante de ISO 8601.

importName
string

El nombre proporcionado por el usuario para esta importación.

importRequestJson
object

La configuración completa de la solicitud de importación como objeto JSON.

importSource
enum<string>

Indica dónde y cómo se inició la importación.

Opciones disponibles:
API,
CRM_UI,
IMPORT,
MOBILE_ANDROID,
MOBILE_IOS,
SALESFORCE
importTemplate
object
Last modified on December 8, 2025