> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Create record

> Create one record in an Airtable table.

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

## Example

```ts automations/create-airtable-record.automation.ts theme={null}
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.