Saltar al contenido principal
POST
/
files
/
v3
/
files
/
import-from-url
/
async
Importar archivo desde URL
curl --request POST \
  --url https://api.hubapi.com/files/v3/files/import-from-url/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "access": "HIDDEN_INDEXABLE",
  "url": "<string>",
  "duplicateValidationScope": "ENTIRE_PORTAL",
  "duplicateValidationStrategy": "NONE",
  "expiresAt": "2023-11-07T05:31:56Z",
  "folderId": "<string>",
  "folderPath": "<string>",
  "name": "<string>",
  "overwrite": true,
  "ttl": "<string>"
}
'
{
  "id": "57122e26-59f8-4cfc-ba53-96e30c816762",
  "links": [
    {
      "status": "https://api.hubspot.com/files/v3/files/import-from-url/async/tasks/57122e26-59f8-4cfc-ba53-96e30c816762/status"
    }
  ]
}

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

application/json
​
access
enum<string>
requerido

PUBLIC_INDEXABLE: el archivo es públicamente accesible para cualquiera que tenga la URL. Los motores de búsqueda pueden indexar el archivo. PUBLIC_NOT_INDEXABLE: el archivo es públicamente accesible para cualquiera que tenga la URL. Los motores de búsqueda no pueden indexar el archivo. PRIVATE: el archivo no es públicamente accesible. Requiere una URL firmada para ver el contenido. Los motores de búsqueda no pueden indexar el archivo.

Opciones disponibles:
HIDDEN_INDEXABLE,
HIDDEN_NOT_INDEXABLE,
HIDDEN_PRIVATE,
HIDDEN_SENSITIVE,
PRIVATE,
PUBLIC_INDEXABLE,
PUBLIC_NOT_INDEXABLE,
SENSITIVE
​
url
string
requerido

URL para descargar el nuevo archivo.

​
duplicateValidationScope
enum<string>

ENTIRE_PORTAL: Buscar un archivo duplicado en toda la cuenta. EXACT_FOLDER: Buscar un archivo duplicado en la carpeta proporcionada.

Opciones disponibles:
ENTIRE_PORTAL,
EXACT_FOLDER
​
duplicateValidationStrategy
enum<string>

NONE: no ejecutes ninguna validación de duplicados. REJECT: rechaza la subida si se encuentra un duplicado. RETURN_EXISTING: si se encuentra un archivo duplicado, no subas un archivo nuevo y devuelve el duplicado encontrado en su lugar.

Opciones disponibles:
NONE,
REJECT,
RETURN_EXISTING
​
expiresAt
string<date-time>

Especifica la fecha y hora en que caducará el archivo.

​
folderId
string

Se requiere folderId o folderPath. Parámetro folderId de destino para el archivo cargado.

​
folderPath
string

Se requiere folderPath o folderId. Ruta de la carpeta de destino para el archivo cargado. Si la ruta de la carpeta no existe, se intentará crearla.

​
name
string

Nuevo nombre. Si se especifica, el nombre de la carpeta y el parámetro fullPath cambiarán. Todos los elementos de la carpeta se actualizarán en consecuencia.

​
overwrite
boolean

Si es verdadero, sobrescribirá el archivo existente si uno con el mismo nombre y extensión existe en la carpeta dada. El archivo sobrescrito se eliminará y el archivo cargado ocupará su lugar con un nuevo ID. Si no se establece o se establece como falso, el nombre del nuevo archivo se actualizará para evitar la colisión con el archivo existente si existe uno con la misma ruta, nombre y extensión.

​
ttl
string

Tiempo de vida. Si se especifica, el archivo se eliminará una vez transcurrido el período indicado. Si no se especifica, el archivo existirá indefinidamente.

Respuesta

accepted

Information on the task that has been started, and where to check it's status.

​
id
string
requerido

ID de la tarea

​
links
object
requerido

Enlaces para consultar información relacionada con la tarea. El enlace "status" proporciona la URL para comprobar el estado de la tarea.

Last modified on March 19, 2026