Passer au contenu principal
POST
/
files
/
v3
/
folders
Créer un dossier
curl --request POST \
  --url https://api.hubapi.com/files/v3/folders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "parentFolderId": "<string>",
  "parentPath": "<string>"
}
'
{
  "archived": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z",
  "archivedAt": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "parentFolderId": "<string>",
  "path": "<string>"
}

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

application/json

Folder creation options

Object for creating a folder.

​
name
string
requis

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

​
parentPath
string

Chemin du dossier du parent du dossier créé. Si non spécifié, le dossier sera créé au niveau de la racine. parentFolderPath et parentFolderId ne peuvent pas être définis en même temps.

Réponse

successful operation

​
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 dossier.

​
updatedAt
string<date-time>
requis

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

​
archivedAt
string<date-time>

Horodatage de la suppression du dossier.

​
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.

Last modified on February 12, 2026