PluginsPlugin Airtable

Create​Create

Create a new record in an Airtable table.

Create one or more new records in an Airtable table. The task can create a single record or multiple records (max 10) in one operation.

yaml
type: "io.kestra.plugin.airtable.records.Create"

Create a single task record

yaml
id: create_airtable_task
namespace: company.airtable

tasks:
  - id: create_task
    type: io.kestra.plugin.airtable.records.Create
    baseId: "{{ secret('AIRTABLE_BASE_ID') }}"
    tableId: "Tasks"
    apiKey: "{{ secret('AIRTABLE_PERSONAL_ACCESS_TOKEN') }}"
    fields:
      "Task Name": "Implement new feature"
      "Status": "Todo"
      "Priority": "High"
      "Due Date": "2024-12-31"
    typecast: true

Create multiple customer records

yaml
id: create_customers
namespace: company.airtable

tasks:
  - id: create_customer_records
    type: io.kestra.plugin.airtable.records.Create
    baseId: "{{ secret('AIRTABLE_BASE_ID') }}"
    tableId: "Customers"
    apiKey: "{{ secret('AIRTABLE_PERSONAL_ACCESS_TOKEN') }}"
    records:
      - "Name": "Acme Corp"
        "Email": "[email protected]"
        "Status": "Active"
      - "Name": "Beta Inc"
        "Email": "[email protected]"
        "Status": "Prospect"
    typecast: true

Create record from dynamic data

yaml
id: create_from_input
namespace: company.airtable

inputs:
  - id: customer_name
    type: STRING
    required: true
  - id: product
    type: STRING
    required: true
  - id: amount
    type: FLOAT
    required: true

tasks:
  - id: create_dynamic_record
    type: io.kestra.plugin.airtable.records.Create
    baseId: "{{ secret('AIRTABLE_BASE_ID') }}"
    tableId: "Orders"
    apiKey: "{{ secret('AIRTABLE_PERSONAL_ACCESS_TOKEN') }}"
    fields:
      "Customer": "{{ inputs.customer_name }}"
      "Product": "{{ inputs.product }}"
      "Amount": "{{ inputs.amount }}"
      "Order Date": "{{ now() }}"
Properties

API key

Airtable API key for authentication

Airtable base ID

The ID of the Airtable base (starts with 'app')

Table ID or name

The ID or name of the table within the base

Fields for single record

Field values for creating a single record. Use this OR the records property, not both.

SubType object

Multiple records

List of records to create (max 10). Each record is a map of field names to values. Use this OR the fields property, not both.

Default false

Typecast

Enable automatic data conversion from string values

Created record

The first created record (for single record creation or first of multiple)

SubType string

Record IDs

List of IDs of the created records

SubType object

All created records

List of all created records