Create record - Automate.ax

createRecord creates one Airtable record and returns the value Airtable stored. Use it when later actions need the provider-assigned record ID.

Example

automations/create-airtable-record.automation.ts

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

export default automation("Create an Airtable task", () => {
  onHttpRequest({ scope: "automation" })
  createRecord({
    base: "Operations",
    table: "Tasks",
    fields: { Name: "Review report", Priority: "High" },
    typecast: true,
  })
})

Inputs

Input	Type	Required	Default	Description
`base`	`string`	Yes	—	Exact base name or stable ID.
`table`	`string`	Yes	—	Table name or stable ID.
`fields`	`Record<string, JsonValue>`	Yes	—	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.
`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 cannot make an incompatible value valid.

⌘I