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

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
access
enum<string>
required

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
required

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 ejecutar ninguna validación de duplicados. REJECT: Rechazar la carga si se encuentra un duplicado. RETURN_EXISTING: Si se encuentra un archivo duplicado, no cargar un archivo nuevo y devolver 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

Nombre que se dará al archivo resultante en el administrador de archivos.

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

Response

accepted

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

​
id
string
required

ID de la tarea

​
links
object
required

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 December 8, 2025