HubSpot

HubSpot Files API

The files API allows you to upload, manage, and organize files in HubSpot's file manager. You can upload files, organize them into folders, control file accessibility and privacy settings, retrieve file details, and attach files to CRM records.

Documentation GitHub OpenAPI

Operations 12

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /files/2026-03/files Upload a file to the file manager · Upload file #

Ask an LLM

“How do I upload an image from my computer into the HubSpot file manager?”

“Can I choose which folder an uploaded file lands in?”

Tell an agent

Upload {file} to the file manager as {fileName}.

Upload {file} into folder path {folderPath}.

POST /files/2026-03/files/import-from-url/async Import a file from a URL · Import file from URL #

Ask an LLM

“Can I pull a file into the file manager straight from a web address?”

“What happens if a file I import from a URL already exists in the folder?”

Tell an agent

Import the file at {url} into folder {folderPath} with {access} access.

Fetch {url} into the file manager as {name}, rejecting duplicates by {duplicateValidationStrategy}.

GET /files/2026-03/files/import-from-url/async/tasks/{taskId}/status Check a URL import's status · Check import status #

Ask an LLM

“Has my import-from-URL file task finished yet?”

“Where do I check whether an asynchronous file import succeeded?”

Tell an agent

Check the status of file import task {taskId}.

Tell me whether URL import {taskId} is complete.

GET /files/2026-03/files/search Search files in the file manager · Search files #

Ask an LLM

“How do I find all PDFs in my file manager?”

“Can I search for images wider than a certain number of pixels?”

Tell an agent

Search the file manager for files named {name}.

Find files with extension {extension} created after {createdAtGte}.

GET /files/2026-03/files/stat/{path} Look up a file by its path · Retrieve file by path #

Ask an LLM

“I know where a file lives in my folders; how do I get its details from that path?”

“Can I fetch file metadata using a folder path instead of an ID?”

Tell an agent

Get the file at path {path}.

Show metadata for the file stored at {path}.

GET /files/2026-03/files/{fileId} Retrieve a file by ID · Retrieve file by ID #

Ask an LLM

“How do I get a file's details when I have its file ID?”

“What properties can I read on a single file by ID?”

Tell an agent

Get file {fileId}.

Retrieve file {fileId} with properties {properties}.

PUT /files/2026-03/files/{fileId} Replace a file's contents · Replace file #

Ask an LLM

“Can I swap an image's content without breaking every page that links to it?”

“How do I overwrite an existing file with a new version while keeping the same ID?”

Tell an agent

Replace the contents of file {fileId} with {file}.

Swap in new image data {file} for existing file {fileId}.

DELETE /files/2026-03/files/{fileId} Delete a file · Delete file by ID #

Ask an LLM

“How do I remove a file I no longer need from the file manager?”

“Is a standard file delete the same as a GDPR delete?”

Tell an agent destructive · confirm first

Delete file {fileId}.

Remove file {fileId} from the file manager with a normal delete.

PATCH /files/2026-03/files/{fileId} Update a file's properties · Update file properties #

Ask an LLM

“Can I rename a file or move it to another folder?”

“How do I stop a file from being offered in new content?”

Tell an agent

Rename file {fileId} to {name}.

Move file {fileId} to folder {parentFolderPath}.

GET /files/2026-03/files/{fileId}/signed-url Get a temporary link to a private file · Get signed URL to access private file #

Ask an LLM

“How can I share a private file temporarily without making it public?”

“Can I control how long a signed file link stays valid?”

Tell an agent

Generate a signed URL for private file {fileId}.

Create a signed link to {fileId} that expires in {expirationSeconds} seconds.

POST /files/2026-03/folders Create a folder · Create folder #

Ask an LLM

“How do I make a new folder in the file manager?”

“Can I create a folder inside an existing folder?”

Tell an agent

Create a folder named {name}.

Create folder {name} under parent path {parentPath}.

HubSpot Files API

Operations 12

Documentation

Specifications

Code Examples

Schemas & Data

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification