> ## 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 Team > Créer une nouvelle équipe dans votre compte HubSpot. Ce point de terminaison vous permet de définir le nom de l'équipe, l'équipe parente et les membres. Le corps de la requête doit inclure le nom de l'équipe et les membres. En cas de création réussie, la réponse inclura l'URL de la ressource d'équipe nouvellement créée. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/settings-teams-v2026-09.json POST /settings/teams/2026-09 openapi: 3.0.1 info: title: Settings Teams 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 paths: /settings/teams/2026-09: post: tags: - Basic summary: Créer une équipe description: >- Créer une nouvelle équipe dans votre compte HubSpot. Ce point de terminaison vous permet de définir le nom de l'équipe, l'équipe parente et les membres. Le corps de la requête doit inclure le nom de l'équipe et les membres. En cas de création réussie, la réponse inclura l'URL de la ressource d'équipe nouvellement créée. operationId: post-/settings/teams/2026-09 parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/TeamCreateRequest' required: true responses: '201': description: successful operation headers: Location: description: URL of the newly created resource style: simple explode: false schema: type: string content: application/json: schema: $ref: '#/components/schemas/TeamResponse' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - settings.users.teams.write components: schemas: TeamCreateRequest: required: - members - name type: object properties: members: type: array description: >- Un ensemble de membres d'équipe à affecter à la nouvelle équipe. Chaque membre est représenté par un objet TeamMemberAssignment. Ce champ est obligatoire. items: $ref: '#/components/schemas/TeamMemberAssignment' name: type: string description: >- Le nom de l'équipe à créer. Ce champ est obligatoire et doit être une chaîne. parentTeamId: type: string description: >- L'identifiant unique de l'équipe parente, si la nouvelle équipe est une sous-équipe. Ce champ est facultatif et doit être une chaîne de caractères s'il est fourni. TeamResponse: required: - id - name type: object properties: id: type: string description: >- L'identifiant unique de l'équipe, représenté sous forme de chaîne de caractères. name: type: string description: Le nom de l'équipe, représenté sous forme de chaîne de caractères. parentTeamId: type: string description: >- L'identifiant unique de l'équipe parente, le cas échéant, représenté sous forme de chaîne de caractères. TeamMemberAssignment: required: - type - userId type: object properties: type: type: string description: "Le type d'affectation du membre de l'équipe. Il s'agit d'une chaîne de caractères qui peut être «\_DEFAULT\_» ou «\_EXTRA\_»." enum: - DEFAULT - EXTRA userId: type: string description: >- L'identifiant unique de l'utilisateur*rice affecté*e à l'équipe. Il s'agit d'une chaîne de caractères. Error: required: - category - correlationId - message type: object properties: category: type: string description: >- La catégorie d'erreur, représentée sous forme de chaine de caractères. context: type: object additionalProperties: type: array items: type: string description: >- Un objet contenant le contexte de la condition d'erreur. Il inclut des propriétés supplémentaires, chacune étant un tableau de chaînes. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la requête, formaté comme un UUID. Celui-ci doit être inclus dans tous les rapports d'erreur ou tickets d'assistance. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: >- Un tableau fournissant des informations supplémentaires sur l'erreur, chaque élément étant un objet ErrorDetail. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associées, fournissant de la documentation sur l'erreur ou les étapes de correction recommandées. Il s'agit d'un objet avec des propriétés de chaîne. message: type: string description: >- Un message lisible par l'utilisateur décrivant l'erreur ainsi que les mesures correctives à prendre, le cas échéant. Il s'agit d'une chaîne de caractères. example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des informations plus détaillées sur l'erreur. Il s'agit d'une chaîne de caractères. 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: >- Le code de statut associé au détail de l'erreur. Il s'agit d'une propriété de type chaîne de caractères. context: type: object additionalProperties: type: array items: type: string description: >- Contexte de la condition d'erreur, représenté sous la forme d'un objet avec des propriétés supplémentaires qui sont des tableaux de chaînes de caractères. example: '{missingScopes=[scope1, scope2]}' in: type: string description: >- Le nom du champ ou du paramètre dans lequel l'erreur a été détectée. Il s'agit d'une propriété de type chaîne de caractères. message: type: string description: >- Un message lisible par l'utilisateur décrivant l'erreur ainsi que les mesures correctives à prendre, le cas échéant. Cette propriété de chaîne est obligatoire. subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur. Il s'agit d'une propriété de type chaîne de caractères. 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: settings.users.teams.read: '' settings.users.teams.write: '' ````