v2

latestOpenAPI 3.1.02026-07-26143251806.6 KB
smart-tables

Create Table

Create a new Table. By default, an empty Sheet 1 with a Column A text column and one empty row is created. Pass create_default_sheet: false to create a table without a default sheet. Requests are scoped to the workspace associated with the API key; table, sheet, column, cell, operation, and version IDs must belong to that workspace.

post/api/public/v2/tables

Request body

titlestring nullable

Table title. Defaults to a unique 'Untitled Table' name if omitted.

folder_idinteger nullable

Folder to place the table in.

create_default_sheetboolean

When true (default), creates Sheet 1 with a Column A text column and one empty row. When false, creates an empty table with no sheets.

Response

Table created. When create_default_sheet is true (default), the response includes default_sheet and table.sheet_count is 1. When create_default_sheet is false, default_sheet is omitted and table.sheet_count is 0.

successboolean required
messagestring