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

Nom souhaité du dossier.

​
parentFolderId
string

ID du dossier du parent du dossier créé. Si non spécifié, le dossier sera créé au niveau de la racine. parentFolderId et parentFolderPath ne peuvent pas être définis 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

Nom du dossier.

​
parentFolderId
string

ID du dossier parent.

​
path
string

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

Last modified on December 8, 2025