Zum Hauptinhalt springen
POST
/
files
/
v3
/
files
/
import-from-url
/
async
Datei von URL importieren
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"
    }
  ]
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Kostenlos

Autorisierungen

​
Authorization
string
header
erforderlich

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

Body

application/json
​
access
enum<string>
erforderlich

PUBLIC_INDEXABLE: Datei ist für alle, die die URL aufrufen, öffentlich zugänglich. Suchmaschinen können die Datei indexieren. PUBLIC_NOT_INDEXABLE: Datei ist für alle, die die URL aufrufen, öffentlich zugänglich. Suchmaschinen können die Datei nicht indexieren. PRIVATE: Datei ist NICHT öffentlich zugänglich. Signierte URL erforderlich, um den Inhalt zu sehen. Suchmaschinen können die Datei nicht indexieren.

Verfügbare Optionen:
HIDDEN_INDEXABLE,
HIDDEN_NOT_INDEXABLE,
HIDDEN_PRIVATE,
HIDDEN_SENSITIVE,
PRIVATE,
PUBLIC_INDEXABLE,
PUBLIC_NOT_INDEXABLE,
SENSITIVE
​
url
string
erforderlich

URL, über die die neue Datei heruntergeladen werden soll.

​
duplicateValidationScope
enum<string>

ENTIRE_PORTAL: Suche nach einer doppelten Datei im gesamten Account. EXACT_FOLDER: Suche nach einer doppelten Datei im angegebenen Ordner.

Verfügbare Optionen:
ENTIRE_PORTAL,
EXACT_FOLDER
​
duplicateValidationStrategy
enum<string>

NONE: Es wird keine doppelte Validierung durchgeführt. REJECT: Der Upload wird verworfen, wenn eine doppelte Datei gefunden wurde. RETURN_EXISTING: Wenn eine doppelte Datei gefunden wurde, keine neue Datei hochladen, sondern stattdessen das gefundene Duplikat zurückgeben.

Verfügbare Optionen:
NONE,
REJECT,
RETURN_EXISTING
​
expiresAt
string<date-time>

Gibt den Zeitpunkt (Datum und Uhrzeit) an, an dem die Datei abläuft.

​
folderId
string

„folderId“ oder „folderPath“ ist erforderlich. Zielordner-folderId für die hochgeladene Datei.

​
folderPath
string

Entweder „folderPath“ oder „folderId“ erforderlich. Zielordnerpfad für die hochgeladene Datei. Wenn der Ordnerpfad nicht vorhanden ist, wird versucht, den Ordnerpfad zu erstellen.

​
name
string

Neuer Name. Sofern angegeben, werden „name“ und „fullPath“ des Ordners geändert. Alle Unterordner des Ordners werden entsprechend aktualisiert.

​
overwrite
boolean

„true“ (wahr) verweist darauf, dass eine vorhandene Datei überschrieben wird, wenn eine Datei mit demselben Namen und derselben Erweiterung im angegebenen Ordner vorhanden ist. Die überschriebene Datei wird gelöscht und durch die hochgeladene Datei ersetzt. Diese erhält eine neue ID. Sofern nicht festgelegt oder „false“ (falsch), wird der Name der neuen Datei aktualisiert, um Konflikte mit vorhandenen Dateien zu vermeiden, falls eine solche mit demselben Pfad, demselben Namen und derselben Erweiterung vorhanden ist.

​
ttl
string

„Time to Live“. Sofern angegeben, wird die Datei nach der angegebenen Zeitspanne gelöscht. Ohne Angabe bleibt die Datei unbegrenzt bestehen.

Antwort

accepted

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

​
id
string
erforderlich

ID der Aufgabe

​
links
object
erforderlich

Links zum Abrufen von Informationen, die sich auf die Aufgabe beziehen. Der „Status“-Link enthält die URL, unter der der Status der Aufgabe angezeigt werden kann.

Last modified on February 12, 2026