Create Custom Table

Creates a new custom table together with its columns in a single request. Requires the acting user to be an owner-admin. The tab value is the target tab's page ID; use Custom Fields > List Custom Fields (list-custom-fields) to find the pageId of an existing field on the desired tab. Use this to create a table backed by multiple columns. For adding a column to a table that already exists, use Create Custom Table Field (create-public-custom-table-field) instead. For a single standalone field not backed by a table, use Custom Fields > Create Custom Field (create-public-custom-field) instead.

OAuth Scopes: employee:custom_fields.write

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

For creating a table, columns is required; any id provided is ignored and a new table id is always assigned.

integer

The id of the Custom Table. Ignored on write: the table id always comes from the path (edit) or is assigned by the server (create).

string
required

The name of the Custom Table to be edited / created

string
enum
required

The type of the Custom Table to be edited / created

Allowed:
required
≥ 1

The id of the tab where the Custom Table will be added or moved. Accepts either the integer or numeric-string form of a page id, such as the pageId returned by List Custom Fields.

string
enum

The sort order direction of the Custom Table

Allowed:
boolean

Whether the Custom Table allows edits or not

columns
array of objects
required

The columns of the Custom Table to be edited / created

columns*
Responses

Language
Credentials
OAuth2
Missing 1 required scope
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json