Updated Jul 15, 2026

Utilities

Airtable integration

Map workflow files to Airtable imports or export table rows, with an offline planning mode.

Agent

overview

What airtable-integration does

Use import to map JSON or line-oriented input into an Airtable table, or export to read rows from a selected base and table. Normal execution contacts Airtable; the optional --dry-run switch writes a plan without provider calls.

The registered FILE inputs carry configuration and source data. Import supports field mapping, optional record linking and update flags; export exposes filtering and field-selection flags. Supply account credentials through workflow secrets when executing against a provider.

The exact rebuilt executable passed seven owned loopback TLS and planning cases. A private four-node workflow passed with downloaded config, fixture, dry-run plan and verifier outputs. These tests do not establish live account permissions, production API compatibility or a provider-side write.

source hub.docker.com/r/nenadzaric/skills-integrations-airtable-integration

use cases

Where airtable-integration fits

Inspect an import plan before executing

Connect a line-oriented FILE and mapping configuration, select import and enable dry-run. Inspect the saved operation plan before configuring provider credentials.

Prepare a table export

Choose base/table and export filters. Dry-run records the intended operation; normal execution requires an account credential and provider access.

Map file fields to table columns

Pass a configuration FILE for JSON field mapping. The planning smoke checks typed file flow and required inputs; it does not prove mapping semantics against a live table.

reference

airtable-integration inputs and flags

19 inputs
NameTypeFlagDescription
export-modeBOOLEANexportGet a table from Airtable while resolving links to other tables
import-modeBOOLEANimportImport a JSON file into Airtable and optionally link records to another table
api-keySTRING--api-keyAirtable API key Bearer credential via workflow secrets; legacy flag name retained; never bake credentials into source or images.
baseSTRING--baseAirtable Base ID
configFILE--configConfig file that contains JQ queries.
input-listFILE--input-listInput list
tableSTRING--tableName of the table where the file will be imported
dry-runBOOLEAN--dry-runOptional: true writes an offline operation plan without provider calls; defaults off. Plan validates required flags/file presence, not provider permissions or mapping semantics.

Showing key inputs. airtable-integration exposes 19 inputs in total.

Full flag reference (19 inputs)
NameTypeFlagDescription
export-modeBOOLEANexportGet a table from Airtable while resolving links to other tables
import-modeBOOLEANimportImport a JSON file into Airtable and optionally link records to another table
api-keySTRING--api-keyAirtable API key Bearer credential via workflow secrets; legacy flag name retained; never bake credentials into source or images.
baseSTRING--baseAirtable Base ID
configFILE--configConfig file that contains JQ queries.
expandBOOLEAN--expandFlag to determine if linked fields should be expanded
expand-fieldsSTRING--expand-fieldsSpecify linked table fields you want to expand (a comma-separated list)
fieldSTRING--fieldName of the field (for use with --input-list)
fieldsSTRING--fieldsName of the field (for use with --input-list)
formulaSTRING--formulaFormula used to filter the table
input-jsonFILE--input-jsonInput JSON
input-listFILE--input-listInput list
link-fieldSTRING--link-fieldName of the common field between the main table and the link table
link-tableSTRING--link-tableName of the table to link to
max-recordsSTRING--max-recordsThe maximum total number of records that will be returned
primary-fieldSTRING--primaryName of the primary field (required with --update)
tableSTRING--tableName of the table where the file will be imported
updateBOOLEAN--updateUpdate the records in the table instead of creating new records
dry-runBOOLEAN--dry-runOptional: true writes an offline operation plan without provider calls; defaults off. Plan validates required flags/file presence, not provider permissions or mapping semantics.

example

Run airtable-integration

airtable-integration · command
airtable-integration import --base fixture --table Fixture --input-list input.txt --config config.json --field Name --dry-run -o plan.json
sample output
{"base":"fixture","dry_run":true,"input_mode":"list","ok":true,"operation":"import","table":"Fixture","update":false}

guidance

Choosing airtable-integration

Use for the adapter’s declared Airtable import/export contract. Prefer a generic HTTP client for routes this adapter does not expose. Keep offline planning distinct from provider execution.

json2html

Renders JSON as an HTML report. Prefer for read-only sharing when nobody needs an editable base.

generate-yaml-report

Builds a structured report file. Prefer when you want a document rather than a synced table.

faq

airtable-integration questions

It writes an offline operation plan and checks required flags and file presence. It does not validate provider permissions, mapping semantics, API compatibility or a completed import/export.

The legacy --api-key flag accepts a Bearer credential. Bind it through workflow secrets for actual execution; do not place credentials in source, images or shared samples. No real account credential was used in these fixtures.

Seven exact-binary owned loopback TLS/planning cases cover import/export success, missing and rejected credentials, malformed responses and both dry-run modes. A private four-node platform run passed planning and typed file flow. No real provider calls were made.

The source link provides immutable image and source-notices commands, bundle SHA-256, recovered Go sources and vendored dependencies, build/test files and installed notices.

Run airtable-integration yourself

Complete downloaded private platform dry-run output using owned synthetic fixture files. This is an offline import plan, not an Airtable response or a created record.

Facts on this page come from the live Trickest tool library.