Passer au contenu principal
POST
/
files
/
2026-03
/
files
/
import-from-url
/
async
Importer un fichier depuis l'URL
curl --request POST \
  --url https://api.hubapi.com/files/2026-03/files/import-from-url/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "overwrite": true,
  "expiresAt": "2023-11-07T05:31:56Z",
  "folderId": "<string>",
  "folderPath": "<string>",
  "name": "<string>",
  "ttl": "<string>",
  "url": "<string>"
}
'
{
  "id": "<string>",
  "links": {}
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt

Use this file to discover all available pages before exploring further.

Supported products

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
​
duplicateValidationScope
enum<string>
requis

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>
requis

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
​
overwrite
boolean
requis

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.

​
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

Nommer le fichier résultant dans le gestionnaire de fichiers.

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

​
url
string

URL pour télécharger le nouveau fichier.

Réponse

accepted

​
id
string
requis

ID de la tâche

​
links
object

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 April 13, 2026