Post /files/v3/files/import From Url/async Import From Url

Import file from URL

POST/files/v3/files/import-from-url/async

Use it in a workflow

Add a step and choose the HubSpot connector.
Pick the Post /files/v3/files/import From Url/async Import From Url action (under Files).
Fill in the fields below, then reference the result from later steps as {{postFilesV3FilesImportFromUrlAsyncImportFromUrl.response.data}}.

Request

Request body

Enter the body as JSON in the step's Body field.

accessstringrequired

PUBLIC_INDEXABLE: File is publicly accessible by anyone who has the URL. Search engines can index the file. PUBLIC_NOT_INDEXABLE: File is publicly accessible by anyone who has the URL. Search engines *can't* index the file. PRIVATE: File is NOT publicly accessible. Requires a signed URL to see content. Search engines *can't* index the file.

One ofHIDDEN_INDEXABLEHIDDEN_NOT_INDEXABLEHIDDEN_PRIVATEHIDDEN_SENSITIVEPRIVATEPUBLIC_INDEXABLEPUBLIC_NOT_INDEXABLESENSITIVE

duplicateValidationScopestring

ENTIRE_PORTAL: Look for a duplicate file in the entire account. EXACT_FOLDER: Look for a duplicate file in the provided folder.

One ofENTIRE_PORTALEXACT_FOLDER

duplicateValidationStrategystring

NONE: Do not run any duplicate validation. REJECT: Reject the upload if a duplicate is found. RETURN_EXISTING: If a duplicate file is found, do not upload a new file and return the found duplicate instead.

One ofNONEREJECTRETURN_EXISTING

expiresAtstring (date-time)

Specifies the date and time when the file will expire.

folderIdstring

One of folderId or folderPath is required. Destination folderId for the uploaded file.

folderPathstring

One of folderPath or folderId is required. Destination folder path for the uploaded file. If the folder path does not exist, there will be an attempt to create the folder path.

namestring

Name to give the resulting file in the file manager.

overwriteboolean

If true, will overwrite existing file if one with the same name and extension exists in the given folder. The overwritten file will be deleted and the uploaded file will take its place with a new ID. If unset or set as false, the new file's name will be updated to prevent colliding with existing file if one exists with the same path, name, and extension

ttlstring

Time to live. If specified the file will be deleted after the given time frame. If left unset, the file will exist indefinitely

urlstringrequired

URL to download the new file from.

json

{
  "access": "HIDDEN_INDEXABLE",
  "url": "string",
  "duplicateValidationScope": "ENTIRE_PORTAL",
  "duplicateValidationStrategy": "NONE",
  "expiresAt": "2025-01-01T00:00:00Z",
  "folderId": "string",
  "folderPath": "string",
  "name": "string",
  "overwrite": false,
  "ttl": "string"
}

Response

Returns 202 with an object. Read it in later steps with {{postFilesV3FilesImportFromUrlAsyncImportFromUrl.response.data.<field>}}.

idstring

ID of the task

linksobject

Links for where to check information related to the task. The `status` link gives the URL for where to check the status of the task.

json

{
  "id": "string",
  "links": {}
}

Need more? See the HubSpot guide for connection setup and behaviour shared by every action.

Was this page helpful?