---
title: "Create a table"
method: POST
path: "/tables"
tags: ["tables"]
---

# Create a table

`POST /tables`

Create a table, this could be internal or external.

## Headers

- `x-budibase-app-id` string, required

## Request body

- Table — The table to be created/updated.
  - `name` string, required — The name of the table.
  - `primaryDisplay` string — The name of the column which should be used in relationship tags when relating to this table.
  - `schema` object, required

## Response `200`

Returns the created table, including the ID which has been generated for it. This can be internal or external datasources.

- TableOutput
  - `data` object, required — The table to be created/updated.
    - `name` string, required — The name of the table.
    - `primaryDisplay` string — The name of the column which should be used in relationship tags when relating to this table.
    - `schema` object, required
    - `_id` string, required — The ID of the table.

---

[API](https://skmtc.net/budibase/apis/budibase-api.md) · [All operations](https://skmtc.net/budibase/apis/budibase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/budibase/budibase-api/versions/9c6f16fc652b/schema)