Create records - Automate.ax

airtable.createRecords creates records in one table, using Airtable’s 10-record API batches. It returns every record in batch order.

Example

automations/import-airtable-records.automation.ts

import { automation, onDashboardRun } from "automate.ax"
import { airtable } from "automate.ax/airtable"

export default automation("Import Airtable leads", () => {
  onDashboardRun({ title: "Import Airtable leads" })
  airtable.createRecords({
    baseId: "appCRM",
    table: "Leads",
    records: [
      { fields: { Name: "Ada", Status: "New" } },
      { fields: { Name: "Grace", Status: "Qualified" } },
    ],
  })
})

Inputs

Input	Type	Required	Default	Description
`baseId`	`string`	Yes	None	Stable Airtable base ID.
`table`	`string`	Yes	None	Table name or stable ID.
`records`	`{ fields: Record<string, JsonValue> }[]`	Yes	None	One or more records to create.
`typecast`	`boolean`	No	`false`	Ask Airtable to coerce string values.
`returnFieldsByFieldId`	`boolean`	No	`false`	Key returned fields by stable IDs.
Second argument: `{ account }`	`string \| IntegrationAccountReference<"airtable">`	No	Project default	Connected Airtable account.

Output

Returns AirtableRecord[]. Each item contains id, createdTime, and fields.

Batches are separate provider requests. If a later batch fails, Airtable does not roll back records created by earlier batches.