---
title: "Import a data table"
method: POST
path: "/tables/import"
tags: ["Tables"]
---

# Import a data table

`POST /tables/import`

## Request

- Base URL: `https://workflow.loopfour.ai/api/v1`
- URL: `https://workflow.loopfour.ai/api/v1/tables/import`
- Auth: API key in header `x-api-key`

Creates a new data table with rows in a single operation.

## Request body

- object
  - `name` string, required: Display name.
  - `description` string
  - `columns` object[], required
    - `id` string
    - `name` string, required
    - `type` string, required
  - `rows` object[], required: Row data objects.
  - `schema` object
  - `metadata` object
  - `maxRows` number

## Response `201`

Table imported

- object
  - `success` unknown
  - `data` DataTable
    - `id` string
    - `name` string
    - `description` string, nullable
    - `columns` object[]
      - `id` string
      - `name` string
      - `type` 'text' | 'number' | 'boolean' | 'date' | 'select' | 'url' | 'email' | 'json'
    - `schema` object, nullable
    - `metadata` object, nullable
    - `maxRows` number
    - `rowCount` number
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `400`: Bad request — invalid parameters or request body.
- `401`: Missing or invalid API key.
- `403`: Forbidden — insufficient permissions for this resource.

---

[API](https://skmtc.dev/loopfour/apis/loopfour-workflows-api.md) - [All operations](https://skmtc.dev/loopfour/apis/loopfour-workflows-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loopfour/apis/loopfour-workflows-api/revisions/872822a3af00?raw)