/airtable

name: airtable
description: "Integrate with Airtable for database management. Use when you need to: (1) create and query Airtable records, (2) manage structured data in bases, or (3) automate data workflows."
version: 1.0.0
skillId: skp-sgzkygrassikberbett539ai
workflowId: c-wl4zkncuw4uv5etp3yb0dy1y
installationId: skpi-h0qwl26a3tovbejlear9z7rq
category: action

Airtable

Integrate with Airtable for database management. Use when you need to: (1) create and query Airtable records, (2) manage structured data in bases, or (3) automate data workflows.

Input

Provide input as JSON:

{
  "base_id": "Airtable base ID (found in the URL when viewing your base)",
  "table_name": "Name of the table to work with",
  "record_data": "Data for the new record in JSON format (e.g., {\"Name\": \"Task 1\", \"Status\": \"In Progress\"})",
  "query_filter": "Optional filter formula for querying records (e.g., {Status} = 'In Progress')"
}

Execution (Pattern C: Action)

Step 1: Run the Skill and Get Run ID

RESULT=$(refly skill run --id skpi-h0qwl26a3tovbejlear9z7rq --input '{
  "base_id": "appXXXXXXXXX",
  "table_name": "Contacts",
  "record_data": {"Name": "John Doe", "Email": "john@example.com"}
}')
RUN_ID=$(echo "$RESULT" | jq -r '.payload.workflowExecutions[0].id')
# RUN_ID is we-xxx format, use this for workflow commands

Step 2: Open Workflow in Browser and Wait for Completion

open "https://refly.ai/workflow/c-wl4zkncuw4uv5etp3yb0dy1y"
refly workflow status "$RUN_ID" --watch --interval 30000

Step 3: Confirm Action Status

# Confirm record created
STATUS=$(refly workflow detail "$RUN_ID" | jq -r '.payload.status')
echo "Action completed with status: $STATUS"

Expected Output

• **Type**: API Response
• **Format**: JSON record data (record ID)
• **Action**: Confirm record created/updated successfully

Rules

Follow base skill workflow: `~/.claude/skills/refly/SKILL.md`