---
title: "Changes to Create a table. Only external table creation is supported.\nWARNING: This API is experimental and will change in future versions."
method: POST
path: "/tables"
---

# Changes to Create a table. Only external table creation is supported.
WARNING: This API is experimental and will change in future versions.

`POST /tables`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 42 revisions.

- **2026-08-24** `73ada80e1f76`: 1 warning, 1 info
- **2026-07-20** `492c1b57757d`: 1 warning, 1 info
- **2026-04-21** `fcc31cda30fc`: 1 warning, 7 info
- **2026-03-23** `a3a215e58c0f`: 1 warning, 1 info
- **2025-11-10** `beba03dc706d`: 2 warning, 2 info
- **2024-09-12** `2dd9fd4253e0`: 3 info
- **2024-08-29** `aba0fdeb4486`: 1 breaking

## Changes

- **2026-08-24** `73ada80e1f76`: 1 warning, 1 info
  - added the new `ICEBERG` enum value to the `data_source_format` response property for the response status `200`
  - added the new `ICEBERG` enum value to the request property `data_source_format`
- **2026-07-20** `492c1b57757d`: 1 warning, 1 info
  - added the new `VIEW` enum value to the `table_type` response property for the response status `200`
  - added the new `VIEW` enum value to the request property `table_type`
- **2026-04-21** `fcc31cda30fc`: 1 warning, 7 info
  - added the new `METRIC_VIEW` enum value to the `table_type` response property for the response status `200`
  - added the new optional request property `view_definition`
  - added the new optional request property `view_dependencies`
  - the request property `data_source_format` became optional
  - the request property `storage_location` became optional
  - added the new `METRIC_VIEW` enum value to the request property `table_type`
  - added the optional property `view_definition` to the response with the `200` status
  - added the optional property `view_dependencies` to the response with the `200` status
- **2026-03-23** `a3a215e58c0f`: 1 warning, 1 info
  - added the new `VARIANT` enum value to the `columns/items/type_name` response property for the response status `200`
  - added the new `VARIANT` enum value to the request property `columns/items/type_name`
- **2025-11-10** `beba03dc706d`: 2 warning, 2 info
  - added the new `MATERIALIZED_VIEW` enum value to the `table_type` response property for the response status `200`
  - added the new `STREAMING_TABLE` enum value to the `table_type` response property for the response status `200`
  - added the new `MATERIALIZED_VIEW` enum value to the request property `table_type`
  - added the new `STREAMING_TABLE` enum value to the request property `table_type`
- **2024-09-12** `2dd9fd4253e0`: 3 info
  - added the optional property `created_by` to the response with the `200` status
  - added the optional property `owner` to the response with the `200` status
  - added the optional property `updated_by` to the response with the `200` status
- **2024-08-29** `aba0fdeb4486`: 1 breaking
  - the request property `storage_location` became required

---

[Operation](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/docs/tables/post.md) - [API](https://skmtc.dev/unitycatalog/apis/unity-catalog-api.md) - [Page](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/changes/tables/post)