Passer au contenu principal
POST
/
cms
/
v3
/
hubdb
/
tables
Créer un nouveau tableau
curl --request POST \
  --url https://api.hubapi.com/cms/v3/hubdb/tables \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "allowChildTables": true,
  "allowPublicApiAccess": true,
  "columns": [
    {
      "id": 123,
      "label": "<string>",
      "name": "<string>",
      "options": [
        {
          "createdAt": "2023-11-07T05:31:56Z",
          "id": "<string>",
          "label": "<string>",
          "name": "<string>",
          "order": 123,
          "type": "<string>",
          "updatedAt": "2023-11-07T05:31:56Z",
          "createdBy": {
            "email": "<string>",
            "firstName": "<string>",
            "id": "<string>",
            "lastName": "<string>"
          },
          "createdByUserId": 123,
          "updatedBy": {
            "email": "<string>",
            "firstName": "<string>",
            "id": "<string>",
            "lastName": "<string>"
          },
          "updatedByUserId": 123
        }
      ],
      "type": "BOOLEAN",
      "foreignColumnId": 123,
      "foreignTableId": 123,
      "maxNumberOfCharacters": 123,
      "maxNumberOfOptions": 123
    }
  ],
  "dynamicMetaTags": {},
  "enableChildTablePages": true,
  "label": "<string>",
  "name": "<string>",
  "useForPages": true
}
'
{
  "allowChildTables": true,
  "allowPublicApiAccess": true,
  "columnCount": 123,
  "columns": "{name: \"column1\"",
  "createdAt": "2023-11-07T05:31:56Z",
  "deleted": true,
  "deletedAt": "2023-11-07T05:31:56Z",
  "dynamicMetaTags": {},
  "enableChildTablePages": true,
  "id": "<string>",
  "label": "<string>",
  "name": "<string>",
  "published": true,
  "publishedAt": "2023-11-07T05:31:56Z",
  "rowCount": 123,
  "updatedAt": "2023-11-07T05:31:56Z",
  "useForPages": true,
  "createdBy": {
    "email": "<string>",
    "firstName": "<string>",
    "id": "<string>",
    "lastName": "<string>"
  },
  "isOrderedManually": true,
  "updatedBy": {
    "email": "<string>",
    "firstName": "<string>",
    "id": "<string>",
    "lastName": "<string>"
  }
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Pro
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Pro

Autorisations

Authorization
string
header
requis

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

Corps

application/json
allowChildTables
boolean
requis

Précise si des tableaux enfants peuvent être créés

allowPublicApiAccess
boolean
requis

Précise si le tableau peut être lu par le public sans autorisation

columns
object[]
requis

Liste des colonnes dans le tableau

dynamicMetaTags
object
requis

Spécifie les paires clé-valeur des champs de métadonnées avec les ID de colonnes associés.

enableChildTablePages
boolean
requis

Précise la création de pages dynamiques à plusieurs niveaux en utilisant des tableaux enfants

label
string
requis

Libellé du tableau

name
string
requis

Nom du tableau

useForPages
boolean
requis

Précise si le tableau peut être utilisé pour la création de pages dynamiques

Réponse

successful operation

allowChildTables
boolean
requis

Précise si des tableaux enfants peuvent être créés

allowPublicApiAccess
boolean
requis

Précise si le tableau peut être lu par le public sans autorisation

columnCount
integer<int32>
requis

Nombre de colonnes y compris supprimées

columns
object[]
requis

Liste des colonnes dans le tableau

Exemple:

"{name: \"column1\""

createdAt
string<date-time>
requis

Horodatage auquel le tableau est créé

deleted
boolean
requis

Précise si le tableau est marqué comme supprimé.

deletedAt
string<date-time>
requis

L'horodatage indiquant quand le tableau a été supprimé.

dynamicMetaTags
object
requis

Spécifie les paires clé-valeur des champs de métadonnées avec les ID de colonnes associés.

enableChildTablePages
boolean
requis

Précise la création de pages dynamiques à plusieurs niveaux en utilisant des tableaux enfants

id
string
requis

ID du tableau

label
string
requis

Libellé du tableau

name
string
requis

Nom du tableau

published
boolean
requis

Indique si le tableau est actuellement publié.

publishedAt
string<date-time>
requis

Horodatage auquel le tableau est publié récemment

rowCount
integer<int32>
requis

Nombre de lignes dans le tableau

updatedAt
string<date-time>
requis

Horodatage auquel le tableau est mis à jour récemment

useForPages
boolean
requis

Précise si le tableau peut être utilisé pour la création de pages dynamiques

createdBy
object
isOrderedManually
boolean

Indique si les lignes du tableau sont classées manuellement.

updatedBy
object
Last modified on December 8, 2025