Batch Create
AI-generatedSummary
Creates multiple rows in a Baserow table via the batch API, grouping input items into chunks of up to 200 rows and sending them as a single POST request to /api/database/rows/table/{tableId}/batch/.
Inputs
- tableId (required) — Baserow table ID (visible in the table URL: /database/TABLE_ID/)
- autoMapAll — When enabled, all JSON keys from incoming items are automatically mapped using the field schema (IDs → names, type-aware sanitization). Default: true.
- useNames — Convert internal field IDs (field_xxx) to human-readable column names in the output. Default: true.
- returnRaw — Return raw Baserow field keys (field_xxx) without any name conversion or value cleaning. Default: false.
- refreshSchema — Force a fresh schema fetch from Baserow, bypassing the 5-minute in-memory cache. Default: false.
- requestTimeout — Timeout for each API request in milliseconds. Increase for large batch operations. Default: 30000.
Output shape
array
Array of created row objects. Field values are mapped to human-readable names when useNames=true and returnRaw=false, returned as raw field_xxx keys when returnRaw=true, or passed through with Baserow-type sanitization (number rounding, select/multi-select value extraction) otherwise. Mapping and cleaning are applied via the mapOutput function which uses idToName and nameToId maps fetched from the field schema (unless refreshed).
Examples
Example 1: Basic batch create with auto mapping
tableId: 123, autoMapAll: true (default), useNames: true (default), returnRaw: false (default). Input items with JSON keys matching Baserow field names are converted to field IDs and written in chunks of 200.
Example 2: Raw field key output
tableId: 123, autoMapAll: true, useNames: false, returnRaw: true. Output contains Baserow-internal field keys (field_xxx) without name conversion or select/multi-select cleaning.
Example 3: Continue on fail
tableId: 123, continueOnFail: true. If a chunk fails, an object { error: error.message, chunk_size: N } is added to the output array and processing continues with remaining chunks.