> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create Folder > Créer un nouveau dossier dans les listes CRM de votre compte HubSpot. Cette opération vous permet d’organiser vos listes en dossiers pour une meilleure gestion et accessibilité. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/crm-lists-v2026-09.json POST /crm/lists/2026-09/folders openapi: 3.0.1 info: title: CRM Lists description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Basic - name: Batch - name: Search paths: /crm/lists/2026-09/folders: post: tags: - Basic summary: Créer un dossier description: >- Créer un nouveau dossier dans les listes CRM de votre compte HubSpot. Cette opération vous permet d’organiser vos listes en dossiers pour une meilleure gestion et accessibilité. operationId: post-/crm/lists/2026-09/folders parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/ListFolderCreateRequest' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/ListFolderCreateResponse' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.lists.write - crm.segments.read - oauth2: - cms.membership.access_groups.write - crm.lists.read - oauth2: - crm.segments.read - crm.segments.write - oauth2: - crm.lists.read - crm.segments.write - oauth2: - crm.lists.read - crm.lists.write - oauth2: - cms.membership.access_groups.write - crm.segments.read components: schemas: ListFolderCreateRequest: required: - name type: object properties: name: type: string description: Une chaîne représentant le nom du dossier à créer. parentFolderId: type: string description: >- Une chaîne représentant l'identifiant unique du dossier parent sous lequel le nouveau dossier sera créé. ListFolderCreateResponse: required: - folder type: object properties: folder: $ref: '#/components/schemas/PublicListFolder' PublicListFolder: required: - childLists - childNodes - id - parentFolderId type: object properties: childLists: type: array description: >- Un tableau de chaînes, chacune représentant l'identifiant unique d'une liste qui est un enfant direct de ce dossier. items: type: integer format: int32 childNodes: type: array description: >- Un tableau de chaînes de caractères, chacune représentant l'identifiant unique d'un nœud enfant, qui peut être un dossier ou une liste. items: $ref: '#/components/schemas/PublicListFolder' createdAt: type: string description: La date et l'heure de création du dossier, au format ISO 8601. format: date-time id: type: string description: >- L'identifiant unique du dossier, représenté sous forme de chaîne de caractères. name: type: string description: Le nom du dossier, représenté sous forme de chaîne de caractères. parentFolderId: type: string description: >- L'identifiant unique du dossier parent, représenté sous forme de chaîne de caractères. Cela indique la structure hiérarchique des dossiers. updatedAt: type: string description: >- La date et l'heure de la dernière mise à jour du dossier, au format ISO 8601. format: date-time updatedContentsAt: type: string description: >- La date et l'heure de la dernière mise à jour du contenu du dossier, au format ISO 8601. format: date-time userId: type: integer description: >- L'identifiant unique de l'utilisateur qui a créé ou mis à jour le dossier pour la dernière fois, représenté sous forme de chaîne de caractères. format: int32 Error: required: - category - correlationId - message type: object properties: category: type: string description: Une chaîne indiquant la catégorie de l'erreur. context: type: object additionalProperties: type: array items: type: string description: >- Un objet contenant un contexte additionnel sur l'erreur, représenté sous forme de carte de paires clé-valeur. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour l'instance d'erreur, utilisé à des fins de suivi et de débogage. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: >- Un tableau d'objets ErrorDetail, chacun fournissant des informations supplémentaires sur les erreurs spécifiques qui se sont produites. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Un objet contenant des liens connexes, représenté sous forme de mappage des noms de liens vers des URL. message: type: string description: >- Une chaîne qui fournit une description de l'erreur lisible par un humain. example: An error occurred subCategory: type: string description: >- Un objet représentant une classification plus spécifique de l'erreur au sein de sa catégorie. description: >- Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération échoue. Ce composant est utilisé dans divers points de terminaison pour fournir des informations détaillées sur l'erreur rencontrée. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base ErrorDetail: required: - message type: object properties: code: type: string description: >- Une chaîne représentant un code d'erreur spécifique qui identifie le type d'erreur. context: type: object additionalProperties: type: array items: type: string description: >- Un objet contenant un contexte additionnel sur l'erreur, représenté comme une carte de chaînes de caractères vers des tableaux de chaînes de caractères, qui peut inclure des paramètres ou des valeurs spécifiques liés à l'erreur. example: '{missingScopes=[scope1, scope2]}' in: type: string description: "Une chaîne indiquant l'emplacement où l'erreur s'est produite, tel que «\_query\_», «\_header\_» ou «\_body\_»." message: type: string description: Une chaîne contenant une description de l'erreur lisible. subCategory: type: string description: >- Un objet fournissant une catégorisation supplémentaire de l'erreur, qui peut contenir des détails supplémentaires. description: >- Représente des informations détaillées sur une erreur survenue dans l'API. Ce composant est utilisé pour fournir un contexte et des spécificités supplémentaires sur les erreurs, généralement dans le cadre d'une réponse d'erreur. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: cms.membership.access_groups.write: '' crm.lists.read: '' crm.lists.write: '' crm.segments.read: '' crm.segments.write: '' ````