Web API

Press shift + S to search API reference.

Bases

Create base

posthttps://api.airtable.com/v0/meta/bases

Creates a new base with the provided tables and returns the schema for the newly created base.

Refer to field types for supported field types, the write format for field options, and other specifics for certain field types. Supported field types have a write format shown.

At least one table and field must be specified. The first field in the fields array will be used as the table's primary field and must be a supported primary field type. Fields must have case-insensitive unique names within the table.

A default grid view will be created with all fields visible for each provided table.

Requirements

AuthenticationPersonal access token, OAuth integration
Scopeschema.bases:write
User role

Workspace creator

Billing plansAll plans

Request body

name
string

The name for the new base.

workspaceId
string

The workspace where the base will be created.

tables
array of Table Configs

A list of JSON objects representing the tables that will be created along with the base.

Response format

id
string

Base ID, a unique identifier for a base.

tables
array of Table models
Request (example)
Copy
$
curl -X POST "https://api.airtable.com/v0/meta/bases" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"name": "Apartment Hunting",
"tables": [
{
"description": "A to-do list of places to visit",
"fields": [
{
"description": "Name of the apartment",
"name": "Name",
"type": "singleLineText"
},
{
"name": "Address",
"type": "singleLineText"
},
{
"name": "Visited",
"options": {
"color": "greenBright",
"icon": "check"
},
"type": "checkbox"
}
],
"name": "Apartments"
}
],
"workspaceId": "wspmhESAta6clCCwF"
}'
200 – Response (example)
{
"id": "appLkNDICXNqxSDhG",
"tables": [
{
"description": "A to-do list of places to visit",
"fields": [
{
"description": "Name of the apartment",
"id": "fld1VnoyuotSTyxW1",
"name": "Name",
"type": "singleLineText"
},
{
"id": "fldoi0c3GaRQJ3xnI",
"name": "Address",
"type": "singleLineText"
},
{
"id": "fldumZe00w09RYTW6",
"name": "Visited",
"options": {
"color": "redBright",
"icon": "star"
},
"type": "checkbox"
}
],
"id": "tbltp8DGLhqbUmjK1",
"name": "Apartments",
"primaryFieldId": "fld1VnoyuotSTyxW1",
"views": [
{
"id": "viwQpsuEDqHFqegkp",
"name": "Grid view",
"type": "grid"
}
]
}
]
}