> ## 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. # Add a row to a table > Ajoutez une nouvelle ligne à un tableau HubDB. Les nouvelles lignes seront ajoutées à la version brouillon du tableau. Utilisez le point de terminaison `/publish` pour pousser ces changements vers la version publiée. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-03/cms-hubdb-v2026-03.json POST /cms/hubdb/2026-03/tables/{tableIdOrName}/rows openapi: 3.0.1 info: title: Hubdb description: Basepom for all HubSpot Projects version: 2026-03 x-hubspot-product-tier-requirements: marketing: PROFESSIONAL sales: FREE service: FREE cms: PROFESSIONAL commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Lignes - name: Rows - name: Tableaux - name: Tables paths: /cms/hubdb/2026-03/tables/{tableIdOrName}/rows: post: tags: - Lignes - Rows summary: Ajouter une nouvelle ligne à un tableau description: >- Ajoutez une nouvelle ligne à un tableau HubDB. Les nouvelles lignes seront ajoutées à la version brouillon du tableau. Utilisez le point de terminaison `/publish` pour pousser ces changements vers la version publiée. operationId: post-/cms/hubdb/2026-03/tables/{tableIdOrName}/rows_createTableRow parameters: - name: tableIdOrName in: path description: >- L’identifiant unique ou le nom du tableau HubDB auquel la nouvelle ligne sera ajoutée. required: true style: simple explode: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/HubDbTableRowV3Request' 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/HubDbTableRowV3' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - hubdb.rows.write components: schemas: HubDbTableRowV3Request: required: - childTableId - displayIndex - values type: object properties: childTableId: type: integer description: Précise la valeur pour l'ID de la colonne du tableau enfant format: int64 displayIndex: type: integer description: La position de l'index pour l'affichage de la ligne dans le tableau. format: int32 name: type: string description: >- Précise la valeur pour la colonne `hs_name`, utilisée comme titre dans les pages dynamiques path: type: string description: >- Précise la valeur pour la colonne `hs_path`, qui sera utilisée comme slug dans les pages dynamiques values: type: object additionalProperties: $ref: '#/components/schemas/Variant' description: >- Liste de paires clé-valeur avec le nom de la colonne et la valeur de la colonne HubDbTableRowV3: required: - childTableId - createdAt - id - name - path - publishedAt - updatedAt - values type: object properties: childTableId: type: string description: Précise la valeur pour l'ID de la colonne du tableau enfant createdAt: type: string description: Horodatage auquel la ligne est créée format: date-time id: type: string description: L'ID de la ligne du tableau name: type: string description: >- Précise la valeur pour la colonne `hs_name`, utilisée comme titre dans les pages dynamiques path: type: string description: >- Précise la valeur pour la colonne `hs_path`, qui sera utilisée comme slug dans les pages dynamiques publishedAt: type: string description: >- L'horodatage indiquant la date de la dernière publication de la ligne, au format date-heure. format: date-time updatedAt: type: string description: Horodatage auquel la ligne a été mise à jour pour la dernière fois format: date-time values: type: object additionalProperties: type: object properties: {} description: >- Liste de paires clé-valeur avec le nom de la colonne et la valeur de la colonne Variant: type: object properties: {} Error: required: - category - correlationId - message type: object properties: category: type: string description: La catégorie d'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreurs ou tickets d'assistance format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: informations supplémentaires à propos de l'erreur items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associés contenant de la documentation sur l'erreur ou les mesures correctives recommandées message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur 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 du statut associé au détail de l'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} in: type: string description: Le nom du champ ou du paramètre dans lequel l'erreur a été trouvée. message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur 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: hubdb.rows.read: '' hubdb.rows.write: '' hubdb.tables.publish: '' hubdb.tables.read: '' hubdb.tables.write: '' ````