HubSpot: Import File From URL

Import a file from a public URL into the HubSpot File Manager, for example an email image hosted elsewhere.

Tool ID: hubspot_import_file_from_url

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'hubspot_import_file_from_url',
  {
    "url": "https://example.com"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute hubspot_import_file_from_url --input '{
  "url": "https://example.com"
}' --json

Example response

The static output schema lacks the details for a reliable example. Use deepline describe hubspot_import_file_from_url --json for the complete live contract.

Input reference

Start an asynchronous HubSpot File Manager import from a public URL. Returns a task ID. read the hosted file URL with hubspot_get_file_import_status. Requires the files scope.

Name	Type	Required	Default	Details
`payload.url`	`string`	Yes	—	Public http(s) URL HubSpot downloads the file from. Minimum length: 1. Pattern: `^https?://`.
`payload.name`	`string`	No	—	File name to store in HubSpot. HubSpot derives one from the URL when omitted. Minimum length: 1.
`payload.folder_path`	`string`	No	—	File Manager folder path, for example `/email-images`. HubSpot creates it when missing. Provide exactly one of `folder_path` or `folder_id`. Minimum length: 1.
`payload.folder_id`	`string`	No	—	File Manager folder ID. Provide exactly one of `folder_path` or `folder_id`. Minimum length: 1.
`payload.access`	`"PUBLIC_NOT_INDEXABLE" \| "PUBLIC_INDEXABLE" \| "PRIVATE"`	No	`"PUBLIC_NOT_INDEXABLE"`	Who can open the file URL. `PUBLIC_NOT_INDEXABLE` (default) is public but hidden from search engines, which suits email images. `PRIVATE` files need a signed URL. Allowed: `PUBLIC_NOT_INDEXABLE`, `PUBLIC_INDEXABLE`, `PRIVATE`.
`payload.overwrite`	`boolean`	No	—	Replace a file with the same name in the same folder instead of renaming the new one.
`payload.duplicate_validation_strategy`	`"NONE" \| "REJECT" \| "RETURN_EXISTING"`	No	—	What HubSpot does when an identical file already exists: upload anyway (`NONE`), fail (`REJECT`), or return the existing file (`RETURN_EXISTING`). Allowed: `NONE`, `REJECT`, `RETURN_EXISTING`.
`payload.duplicate_validation_scope`	`"ENTIRE_PORTAL" \| "EXACT_FOLDER"`	No	—	Where HubSpot looks for a duplicate file. Allowed: `ENTIRE_PORTAL`, `EXACT_FOLDER`.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`record`	Yes	—	Provider response payload.
`result.meta`	`record`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation