Skip to main content
POST
/
table
/
{tableId}
/
record
/
form-submit
cURL
curl --request POST \
  --url https://app.teable.ai/api/table/%7BtableId%7D/record/form-submit \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json' \
  --data '{"viewId":"string","fields":{"property1":null,"property2":null},"typecast":true}'
{
  "id": "<string>",
  "fields": {},
  "name": "<string>",
  "autoNumber": 123,
  "createdTime": "<string>",
  "lastModifiedTime": "<string>",
  "createdBy": "<string>",
  "lastModifiedBy": "<string>",
  "permissions": {},
  "undeletable": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
tableId
string
required

Body

application/json
​
viewId
string
required

Form view ID

​
fields
object
required

Objects with a fields key mapping fieldId or field name to value for that field.

​
typecast
boolean

Response

201 - application/json

Returns the created record.

​
id
string
required

The record id.

​
fields
object
required

Objects with a fields key mapping fieldId or field name to value for that field.

​
name
string

primary field value

​
autoNumber
number

Auto number, a unique identifier for each record

​
createdTime
string

Created time, date ISO string (new Date().toISOString).

​
lastModifiedTime
string

Last modified time, date ISO string (new Date().toISOString).

​
createdBy
string

Created by, user name

​
lastModifiedBy
string

Last modified by, user name

​
permissions
object

Permissions for the record

​
undeletable
boolean

Whether the record is undeletable

Last modified on March 5, 2026