Sign in
Advanced

Upload file

Upload a new file to the HubSpot file manager. This endpoint allows you to specify the file, its name, and the folder where it should be stored. It supports additional options such as specifying a character set or additional options for the file.

post/files/2026-09-beta/files

Response

successful operation

access'HIDDEN_INDEXABLE' | 'HIDDEN_NOT_INDEXABLE' | 'HIDDEN_PRIVATE' | 'HIDDEN_SENSITIVE' | 'PRIVATE' | 'PUBLIC_INDEXABLE' | 'PUBLIC_NOT_INDEXABLE' | 'SENSITIVE'

The access level of the file, represented as a string. Valid values include 'PUBLIC_INDEXABLE', 'PUBLIC_NOT_INDEXABLE', 'HIDDEN_INDEXABLE', 'HIDDEN_NOT_INDEXABLE', 'HIDDEN_PRIVATE', 'PRIVATE', 'HIDDEN_SENSITIVE', and 'SENSITIVE'.

archivedboolean required

A boolean indicating whether the file is archived.

archivedAtstring date-time

The date and time when the file was deleted, in ISO 8601 format.

createdAtstring date-time required

The date and time when the file was created, in ISO 8601 format.

defaultHostingUrlstring

The static cdn URL where the file is hosted.

encodingstring

The encoding of the file.

expiresAtinteger

The expiration epoch timestamp, if set.

extensionstring

The file extension.

fileMd5string

The MD5 hash of the file.

heightinteger

The height of the file in pixels, applicable if the file is an image or video.

idstring required

The ID of the file.

isUsableInContentboolean

A boolean indicating whether the file can be used in content.

namestring

The name of the file.

parentFolderIdstring

The unique identifier of the parent folder containing the file, represented as a string.

pathstring

The path of the file within the file manager.

sizeinteger

The size of the file in bytes.

sourceGroup'CONTENT' | 'CONVERSATIONS' | 'FORMS' | 'UI_EXTENSIONS' | 'UNKNOWN'

The source group of the file, with possible values including 'UNKNOWN', 'CONTENT', 'FORMS', 'CONVERSATIONS', and 'UI_EXTENSIONS'.

typestring

The type of the file. Values include: IMG, DOCUMENT, AUDIO, MOVIE, OTHER.

updatedAtstring date-time required

The date and time when the file was last updated, in ISO 8601 format.

urlstring

The URL where the file can be accessed, represented as a string.

widthinteger

The width of the file in pixels, applicable if the file is an image or video.