---
title: "Create a table.
WARNING: This API is experimental and will change in future versions."
method: POST
path: "/tables"
tags: ["Tables"]
---

# Create a table.
WARNING: This API is experimental and will change in future versions.

`POST /tables`

Creates a new table instance.
WARNING: This API is experimental and will change in future versions.

## Request body

- CreateTable
  - `name` string, required — Name of table, relative to parent schema.
  - `catalog_name` string, required — Name of parent catalog.
  - `schema_name` string, required — Name of parent schema relative to its parent catalog.
  - `table_type` 'MANAGED' | 'EXTERNAL', required
  - `data_source_format` 'DELTA' | 'CSV' | 'JSON' | 'AVRO' | 'PARQUET' | 'ORC' | 'TEXT', required — Data source format
  - `columns` ColumnInfo[], required — The array of __ColumnInfo__ definitions of the table's columns.
    - `name` string — Name of Column.
    - `type_text` string — Full data type specification as SQL/catalogString text.
    - `type_json` string — Full data type specification, JSON-serialized.
    - `type_name` 'BOOLEAN' | 'BYTE' | 'SHORT' | 'INT' | 'LONG' | 'FLOAT' | 'DOUBLE' | 'DATE' | 'TIMESTAMP' | 'TIMESTAMP_NTZ' | 'STRING' | 'BINARY' | 'DECIMAL' | 'INTERVAL' | 'ARRAY' | 'STRUCT' | 'MAP' | 'CHAR' | 'NULL' | 'USER_DEFINED_TYPE' | 'TABLE_TYPE' — Name of type (INT, STRUCT, MAP, etc.).
    - `type_precision` integer — Digits of precision; required for DecimalTypes.
    - `type_scale` integer — Digits to right of decimal; Required for DecimalTypes.
    - `type_interval_type` string — Format of IntervalType.
    - `position` integer — Ordinal position of column (starting at position 0).
    - `comment` string — User-provided free-form text description.
    - `nullable` boolean — Whether field may be Null.
    - `partition_index` integer — Partition index for column.
  - `storage_location` string — Storage root URL for table (for **MANAGED**, **EXTERNAL** tables)
  - `comment` string — User-provided free-form text description.
  - `properties` SecurablePropertiesMap — A map of key-value properties attached to the securable.

## Response `200`

The new table was successfully created.

- TableInfo
  - `name` string — Name of table, relative to parent schema.
  - `catalog_name` string — Name of parent catalog.
  - `schema_name` string — Name of parent schema relative to its parent catalog.
  - `table_type` 'MANAGED' | 'EXTERNAL'
  - `data_source_format` 'DELTA' | 'CSV' | 'JSON' | 'AVRO' | 'PARQUET' | 'ORC' | 'TEXT' — Data source format
  - `columns` ColumnInfo[] — The array of __ColumnInfo__ definitions of the table's columns.
    - `name` string — Name of Column.
    - `type_text` string — Full data type specification as SQL/catalogString text.
    - `type_json` string — Full data type specification, JSON-serialized.
    - `type_name` 'BOOLEAN' | 'BYTE' | 'SHORT' | 'INT' | 'LONG' | 'FLOAT' | 'DOUBLE' | 'DATE' | 'TIMESTAMP' | 'TIMESTAMP_NTZ' | 'STRING' | 'BINARY' | 'DECIMAL' | 'INTERVAL' | 'ARRAY' | 'STRUCT' | 'MAP' | 'CHAR' | 'NULL' | 'USER_DEFINED_TYPE' | 'TABLE_TYPE' — Name of type (INT, STRUCT, MAP, etc.).
    - `type_precision` integer — Digits of precision; required for DecimalTypes.
    - `type_scale` integer — Digits to right of decimal; Required for DecimalTypes.
    - `type_interval_type` string — Format of IntervalType.
    - `position` integer — Ordinal position of column (starting at position 0).
    - `comment` string — User-provided free-form text description.
    - `nullable` boolean — Whether field may be Null.
    - `partition_index` integer — Partition index for column.
  - `storage_location` string — Storage root URL for table (for **MANAGED**, **EXTERNAL** tables)
  - `comment` string — User-provided free-form text description.
  - `properties` SecurablePropertiesMap — A map of key-value properties attached to the securable.
  - `created_at` integer — Time at which this table was created, in epoch milliseconds.
  - `updated_at` integer — Time at which this table was last modified, in epoch milliseconds.
  - `table_id` string — Unique identifier for the table.

---

[API](https://skmtc.dev/unitycatalog/apis/unity-catalog-api.md) · [All operations](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unitycatalog/unity-catalog-api/revisions/afb7536b3c70/schema)