Skip to main content
POST
Create field
Both type and name are required. The template object structure varies by field type - see Field Types Reference for complete details

Example Field Creation

Here’s how to create a single select field:
Option colors are palette keys (purple, orange, blue, gray, red, yellow, green, pink, lime, tangerine, emerald, sky, teal, indigo, cyan, violet, fuchsia), not hex codes. Omit color to have one assigned.

Authorizations

Authorization
string
header
required

Enter your Zite API key. Format: Bearer <api_key>

Path Parameters

databaseId
string
required

The unique identifier of the database

tableId
string
required

The unique identifier of the table. You can also use the table name instead of the ID.

Body

application/json
type
enum<string>
required

Field type. See Field types for the value shape and template of each type.

Available options:
single_line_text,
long_text,
rich_text,
email,
url,
phone_number,
number,
currency,
percent,
rating,
duration,
single_select,
multiple_select,
checkbox,
date,
datetime,
attachments,
linked_record,
lookup,
rollup,
formula,
autonumber,
source,
created_at,
updated_at,
created_by,
updated_by,
user
name
string
required

Field name

Minimum string length: 1
template
object

Field-specific configuration. Optional, except for linked_record, lookup, rollup, and formula; source needs an empty object ({}). See Field types for the template of each type.

Response

Field created successfully

id
string
required

Unique identifier for the field

name
string
required

Name of the field

type
enum<string>
required

Field type. See Field types for the value shape and template of each type.

Available options:
single_line_text,
long_text,
rich_text,
email,
url,
phone_number,
number,
currency,
percent,
rating,
duration,
single_select,
multiple_select,
checkbox,
date,
datetime,
attachments,
linked_record,
lookup,
rollup,
formula,
autonumber,
source,
created_at,
updated_at,
created_by,
updated_by,
user
template
object
required

Field-specific configuration options. See Field types for detailed template structure by field type.

order
integer
required

Display order of the field