Passer au contenu principal
POST
/
files
/
v3
/
files
Charger le fichier
curl --request POST \
  --url https://api.hubapi.com/files/v3/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'charsetHunch=<string>' \
  --form file='@example-file' \
  --form 'fileName=<string>' \
  --form 'folderId=<string>' \
  --form 'folderPath=<string>' \
  --form 'options=<string>'
{
  "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": "CONTENT",
  "type": "<string>",
  "url": "<string>",
  "width": 123
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Gratuit
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Gratuit

Autorisations

​
Authorization
string
header
requis

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

Corps

multipart/form-data
​
charsetHunch
string

Character set of the uploaded file.

​
file
file

File to be uploaded.

​
fileName
string

Desired name for the uploaded file.

​
folderId
string

Either 'folderId' or 'folderPath' is required. folderId is the ID of the folder the file will be uploaded to.

​
folderPath
string

Either 'folderPath' or 'folderId' is required. This field represents the destination folder path for the uploaded file. If a path doesn't exist, the system will try to create one.

​
options
string

JSON string representing FileUploadOptions.

Réponse

successful operation

File

​
access
enum<string>
requis

PUBLIC_INDEXABLE : le fichier est accessible publiquement par les personnes possédant l'URL. Les moteurs de recherche peuvent indexer le fichier. PUBLIC_NOT_INDEXABLE : le fichier est accessible publiquement par les personnes possédant l'URL. Les moteurs de recherche ne peuvent pas indexer le fichier. PRIVATE : le fichier n'est PAS accessible publiquement. Une URL signée est nécessaire pour voir le contenu. Les moteurs de recherche ne peuvent pas indexer le fichier.

Options disponibles:
HIDDEN_INDEXABLE,
HIDDEN_NOT_INDEXABLE,
HIDDEN_PRIVATE,
HIDDEN_SENSITIVE,
PRIVATE,
PUBLIC_INDEXABLE,
PUBLIC_NOT_INDEXABLE,
SENSITIVE
​
archived
boolean
requis

Indique si le dossier est supprimé ou non.

​
createdAt
string<date-time>
requis

Horodatage de la création du dossier.

​
id
string
requis

ID du fichier.

​
updatedAt
string<date-time>
requis

Horodatage de la dernière mise à jour du dossier.

​
archivedAt
string<date-time>

Horodatage de la suppression du dossier.

​
defaultHostingUrl
string

URL d'hébergement par défaut du fichier. Cela utilisera l'une des URL fournies par HubSpot pour gérer le fichier.

​
encoding
string

Encodage du fichier.

​
expiresAt
integer<int64>
​
extension
string

Extension du fichier demandé.

​
fileMd5
string

Le hachage MD5 du fichier.

​
height
integer<int32>

Pour les fichiers image et vidéo. La hauteur du fichier.

​
isUsableInContent
boolean

Indiquez si le fichier doit être utilisé dans le nouveau contenu ou non.

​
name
string

Nouveau nom. Si spécifié, le nom du dossier et fullPath changeront. Tous les dossiers enfants seront mis à jour en conséquence.

​
parentFolderId
string

Nouvel ID de dossier parent. S'il est modifié, le dossier et tous les dossiers enfants seront déplacés dans le dossier spécifié. parentFolderId et parentFolderPath ne peuvent pas être spécifiés en même temps

​
path
string

Chemin d'accès du dossier dans le gestionnaire de fichiers.

​
size
integer<int64>

Taille en octets du fichier demandé.

​
sourceGroup
enum<string>
Options disponibles:
CONTENT,
CONVERSATIONS,
FORMS,
UI_EXTENSIONS,
UNKNOWN
​
type
string

Type de fichier. Peut être IMG, DOCUMENT, AUDIO, MOVIE ou OTHER.

​
url
string

URL pour télécharger le nouveau fichier.

​
width
integer<int32>

Pour les fichiers image et vidéo. La largeur du fichier.

Last modified on February 12, 2026