Skip to documentation
Airtable integration

Create or Update Record

Perform Create or Update Record through Airtable.

View as Markdown
airtable_upsert_record
writeairtable

Inputs

  • base_id
    expressionrequired
    Base Id

    Required literal value or workflow expression.

  • table
    expressionrequired
    Table

    Required literal value or workflow expression.

  • fields
    jsonrequired
    Fields

    Required JSON value.

  • fields_to_merge_on
    textrequired
    Fields To Merge On

    Required text value.

  • typecast
    boolean
    Typecast

    Optional true-or-false value.

    Default: false

Outputs

  • createdCreated
  • record_idRecord Id
  • recordRecord
  • fieldsFields
  • successSuccess
  • errorError
  • error_typeError Type
  • status_codeStatus Code

Output schema completeness: best_effort_declared

Safety

External effect
write
Confirmation recommended
No
Retry safe
No
Dry run supported
No

Schemas

These schemas are first-pass authoring guidance. Runtime validation remains authoritative.

Input schema
{
  "type": "object",
  "required": [
    "base_id",
    "table",
    "fields",
    "fields_to_merge_on"
  ],
  "properties": {
    "table": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "fields": {
      "description": "Required JSON value.",
      "x-workflow-field-type": "json"
    },
    "base_id": {
      "description": "Required literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "typecast": {
      "type": "boolean",
      "default": false,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "fields_to_merge_on": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    }
  },
  "additionalProperties": false
}
Output schema
{
  "type": "object",
  "properties": {
    "error": {},
    "fields": {},
    "record": {},
    "created": {},
    "success": {},
    "record_id": {},
    "error_type": {},
    "status_code": {}
  },
  "additionalProperties": true
}
View all Airtable actions