POST
/
files
/
v3
/
files
/
import-from-url
/
async
Import file from 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 '{
  "folderPath": "<string>",
  "access": "PUBLIC_INDEXABLE",
  "duplicateValidationScope": "ENTIRE_PORTAL",
  "name": "<string>",
  "duplicateValidationStrategy": "NONE",
  "ttl": "<string>",
  "overwrite": true,
  "expiresAt": "2023-11-07T05:31:56Z",
  "url": "<string>",
  "folderId": "<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"
    }
  ]
}
Supported products
Requires one of the following products or higher.
Marketing HubMarketing HubFree
Sales HubSales HubFree
Service HubService HubFree
Content HubContent HubStarter

​
Required Scopes

This API requires one of the following scopes:
  • files

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Response

202
application/json

accepted

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