Zum Hauptinhalt springen
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 '{
  "parentFolderId": "<string>",
  "parentPath": "<string>",
  "name": "<string>"
}'
{
  "createdAt": "2023-11-07T05:31:56Z",
  "archivedAt": "2023-11-07T05:31:56Z",
  "path": "<string>",
  "archived": true,
  "parentFolderId": "<string>",
  "name": "<string>",
  "id": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z"
}
Produits pris en charge
Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing HubGratuit
Sales HubSales HubGratuit
Service HubService HubGratuit
Content HubContent HubStarter

​
Portées requises

Cette API requiert l’une des portées suivantes :
  • files

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Folder creation options

Object for creating a folder.

​
name
string
required

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.

Response

successful operation

​
createdAt
string<date-time>
required

Horodatage de la création du dossier.

​
archived
boolean
required

Indique si le dossier est supprimé ou non.

​
id
string
required

ID du dossier.

​
updatedAt
string<date-time>
required

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

​
archivedAt
string<date-time>

Horodatage de la suppression du dossier.

​
path
string

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

​
parentFolderId
string

ID du dossier parent.

​
name
string

Nom du dossier.

⌘I