---
title: list_tables, create_table, update_table
description: Create and manage structured data tables.
section: MCP Reference
order: 8
---

# list_tables, create_table, update_table

Create and manage structured data tables.

> **Full documentation:** [Data Tables](/docs/tables) — Liquid access, public JSON API, template pages, and more.

## Actions

### list

List all tables for a website. Pass `table_id` to retrieve a single table.

**Parameters:**
- `website` — Website subdomain, domain, or UUID
- `table_id` — Optional table UUID to retrieve a single table

### create

Create a new table.

**Parameters:**
- `website` — Website subdomain, domain, or UUID
- `name` — Human-readable table name
- `slug` — URL-safe identifier (auto-generated from name)
- `display_column_key` — Field name for slug generation
- `fields_schema` — Field definitions: `{ fields: [{ name, type }] }`
  - Types: `string`, `text`, `boolean`, `datetime`, `number`

### update

Update table settings.

**Parameters:**
- `table_id` — Table UUID
- `name` — Update name (optional)
- `display_column_key` — Update display column (optional)

## OAuth Scopes

| Action | Scope |
|--------|-------|
| list | `table:read` |
| create | `table:create` |
| update | `table:edit` |