Create record - Automate.ax

airtable.createRecord creates a record and returns Airtable’s stored value, including the provider-assigned ID.

Example

automations/create-airtable-record.automation.ts

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

export default automation("Create an Airtable task", () => {
  onDashboardRun({ title: "Create an Airtable task" })
  airtable.createRecord({
    baseId: "appOperations",
    table: "Tasks",
    fields: { Name: "Review report", Priority: "High" },
    typecast: true,
  })
})

Inputs

Input	Type	Required	Default	Description
`baseId`	`string`	Yes	None	Stable Airtable base ID.
`table`	`string`	Yes	None	Table name or stable ID.
`fields`	`Record<string, JsonValue>`	Yes	None	Values keyed by field name or ID.
`typecast`	`boolean`	No	`false`	Ask Airtable to coerce strings to destination field types.
`returnFieldsByFieldId`	`boolean`	No	`false`	Key returned fields by stable ID instead of name.
Second argument: `{ account }`	`string \| IntegrationAccountReference<"airtable">`	No	Project default	Connected Airtable account.

Output

Returns the created record with id, createdTime, and fields. Unknown fields, invalid values, and insufficient table permissions fail with Airtable’s provider error. typecast enables Airtable’s normal coercion but can’t make an incompatible value valid.