---
title: "POST /tables/import"
method: POST
path: "/tables/import"
---

# POST /tables/import

`POST /tables/import`

Creates a new Big Table from a URL

## Query parameters

- `appsToLink` string[] — An array of app IDs to link the new table to.
- `onSchemaError` 'abort' | 'dropColumns' | 'updateSchema' — The action to take when the passed data does not match the table schema: - `abort`: Abort the entire operation and return an error. - `dropColumns`: Ignore the data that caused the error, and do not import those columns in the affected rows. - `updateSchema`: Update the schema as needed to add any missing columns or widen the data types of existing columns, and then import the data from them.

## Request body

- object
  - `displayName` string — Name of the table, e.g., `Invoices`
  - `fromUrl` string, uri, required — The url of the table to fetch from. Required when the name is not passed in the request body. It is an error to pass a name in both this query parameter and the request body.
  - `appsToLink` string[] — An array of app IDs to link the new table to.

## Response `201`

- object
  - `data` object[], required
    - `tableID` string, required — ID of the table, e.g., `2a1bad8b-cf7c-44437-b8c1-e3782df6`
    - `rowIDs` string[], required — Row IDs of added rows, returned in the same order as the input rows, e.g., ```json [ "zcJWnyI8Tbam21V34K8MNA", "93a19-cf7c-44437-b8c1-e9acbbb" ] ```
    - `linkedAppIDs` string[] — An array of appIDs which were successfully linked.

## Other responses

- `400`
- `402`
- `422`

## Changes

- **2025-09-22** `0d706382896f` — 1 warning
  - deleted the `header` request parameter `x-glide-asynchronous`
- **2025-09-18** `d33dfbf12a0e` — 2 info
  - added the new optional `header` request parameter `x-glide-asynchronous`
  - added the new optional request property `displayName`
- **2025-06-10** `7e88aa38abcd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/glideapps/apis/untitled-api/changes/tables/import/post.md)

---

[API](https://skmtc.dev/glideapps/apis/untitled-api.md) · [All operations](https://skmtc.dev/glideapps/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/glideapps/untitled-api/revisions/ecab03a9d56a/schema)