post
https://api.talkdeskapp.com/data-tables/import
Create a new data table and immediately import rows from a CSV or JSON file in a single
atomic operation. If the file import fails after the table has been created, the table
is rolled back.
The schema part defines the table structure; the file part contains the rows.
Schema constraints:
columnsmust include exactly one entry withdisplay_name: key(case-insensitive),
which must havetype: STRING. This becomes the row key column.- Column
display_namevalues must be unique (case-insensitive). - Maximum 100 columns total (including the key column).
File constraints:
- CSV: max 10 MB
- JSON: max 2 MB
- File type determined by extension (
.csvor.json) or content type
CSV format:
- Delimiter: comma
- Encoding: UTF-8 (BOM stripped if present)
- Quoting: RFC 4180
- Headers must exactly match the table's column slugs (including
key) - Empty fields treated as null (column not set)
JSON format:
- Must be a top-level array of objects
- Each object must include all table column slugs as keys
- Values are natively typed (strings, numbers, booleans, null)
Validation pipeline (fail-fast, atomic):
- File type and size validation
- Schema definition validation (key column, duplicates, column count)
- Table creation (name uniqueness, account table limit)
- File parsing and header matching against table schema
- Row-level validation (empty keys, duplicate deduplication, row limit, type checks)
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…