Passer au contenu principal
POST
/
files
/
v3
/
files
/
import-from-url
/
async
Importer un fichier depuis l'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"
    }
  ]
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Gratuit
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Gratuit

Autorisations

​
Authorization
string
header
requis

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

Corps

application/json
​
access
enum<string>
requis

PUBLIC_INDEXABLE : le fichier est accessible publiquement par les personnes possédant l'URL. Les moteurs de recherche peuvent indexer le fichier. PUBLIC_NOT_INDEXABLE : le fichier est accessible publiquement par les personnes possédant l'URL. Les moteurs de recherche ne peuvent pas indexer le fichier. PRIVATE : le fichier n'est PAS accessible publiquement. Une URL signée est nécessaire pour voir le contenu. Les moteurs de recherche ne peuvent pas indexer le fichier.

Options disponibles:
HIDDEN_INDEXABLE,
HIDDEN_NOT_INDEXABLE,
HIDDEN_PRIVATE,
HIDDEN_SENSITIVE,
PRIVATE,
PUBLIC_INDEXABLE,
PUBLIC_NOT_INDEXABLE,
SENSITIVE
​
url
string
requis

URL pour télécharger le nouveau fichier.

​
duplicateValidationScope
enum<string>

ENTIRE_PORTAL : rechercher un fichier doublon dans l'ensemble du compte. EXACT_FOLDER : rechercher un fichier doublon dans le dossier fourni.

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

NONE : ne pas exécuter la validation de doublon. REJECT : rejeter le chargement si un doublon est trouvé. RETURN_EXISTING : si un fichier doublon est trouvé, ne pas téléverser de nouveau fichier et renvoyer le doublon trouvé à la place.

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

Spécifie la date et l'heure auxquelles le fichier expirera.

​
folderId
string

Un folderId ou folderPath est requis. folderId de destination pour le fichier chargé.

​
folderPath
string

Un folderPath ou folderId est requis. Chemin du dossier de destination pour le fichier chargé. Si le chemin du dossier n'existe pas, une tentative de création du chemin du dossier sera effectuée.

​
name
string

Nouveau nom. Si spécifié, le nom du dossier et fullPath changeront. Tous les dossiers enfants seront mis à jour en conséquence.

​
overwrite
boolean

Si vrai, le fichier existant sera écrasé s'il en existe un avec le même nom et la même extension dans le dossier donné. Le fichier écrasé sera supprimé et le fichier chargé prendra sa place avec un nouvel identifiant. Si non défini ou défini comme faux, le nom du nouveau fichier sera mis à jour pour éviter tout conflit avec un fichier existant s'il en existe un avec le même chemin, nom et extension.

​
ttl
string

Durée de vie. Si spécifié, le fichier sera supprimé après le délai indiqué. Si non défini, le fichier existera indéfiniment.

Réponse

accepted

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

​
id
string
requis

ID de la tâche

​
links
object
requis

Liens pour vérifier les informations relatives à la tâche. Le lien « statut » donne l'URL pour vérifier le statut de la tâche.

Last modified on February 12, 2026