Skip to main content
GET
/
files
/
v3
/
files
/
import-from-url
/
async
/
tasks
/
{taskId}
/
status
Check import status
curl --request GET \
  --url https://api.hubapi.com/files/v3/files/import-from-url/async/tasks/{taskId}/status \
  --header 'Authorization: Bearer <token>'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED",
  "taskId": "<string>",
  "errors": [
    {
      "category": "<string>",
      "context": {},
      "errors": [
        {
          "message": "<string>",
          "code": "<string>",
          "context": "{missingScopes=[scope1, scope2]}",
          "in": "<string>",
          "subCategory": "<string>"
        }
      ],
      "links": {},
      "message": "<string>",
      "status": "<string>",
      "id": "<string>",
      "subCategory": {}
    }
  ],
  "links": {},
  "numErrors": 123,
  "requestedAt": "2023-11-07T05:31:56Z",
  "result": {
    "access": "HIDDEN_INDEXABLE",
    "archived": true,
    "createdAt": "2023-11-07T05:31:56Z",
    "id": "<string>",
    "updatedAt": "2023-11-07T05:31:56Z",
    "archivedAt": "2023-11-07T05:31:56Z",
    "defaultHostingUrl": "<string>",
    "encoding": "<string>",
    "expiresAt": 123,
    "extension": "<string>",
    "fileMd5": "<string>",
    "height": 123,
    "isUsableInContent": true,
    "name": "<string>",
    "parentFolderId": "<string>",
    "path": "<string>",
    "size": 123,
    "sourceGroup": "<string>",
    "type": "<string>",
    "url": "<string>",
    "width": 123
  }
}

Supported products

Requires one of the following products or higher.
Marketing HubMarketing Hub -Free
Sales HubSales Hub -Free
Service HubService Hub -Free
Content HubContent Hub -Free
Data HubData Hub -Free

Authorizations

Authorization
string
header
required

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

Path Parameters

taskId
string
required

Import by URL task ID

Response

successful operation

completedAt
string<date-time>
required

Time of completion of task.

startedAt
string<date-time>
required

Timestamp of when the task was started.

status
enum<string>
required

Current status of the task.

Available options:
CANCELED,
COMPLETE,
PENDING,
PROCESSING
taskId
string
required

ID of the requested task.

errors
object[]

Descriptive error messages.

Link to check the status of the requested task.

numErrors
integer<int32>

Number of errors resulting from the task.

requestedAt
string<date-time>

Timestamp of when the task was requested.

result
object

File

Last modified on December 16, 2025