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

# Airtable

> How to set up the Airtable connector, plus the actions that are available.

![Airtable](https://stackone-logos.com/api/airtable/filled/svg)

v2.0.0[See changelog](https://docs.stackone.com/connectors/airtable/changelog.md)

[90 actions](#actions) · 3 auth methods

Databases
IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [MCP (OAuth) · Connector Profile](https://docs.stackone.com/connectors/airtable/guides/connector-profile/mcp-oauth.md)
>
> Authorize through the MCP server. Endpoints and client registration are discovered at connect time.

> [card] [Personal Access Token · Connector Profile](https://docs.stackone.com/connectors/airtable/guides/connector-profile/personal-access-token.md)
>
> No app registration required. The token acts with the access of the user who created it, limited to the scopes and bases...

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/airtable/guides/connector-profile/oauth-2-0.md)
>
> Requires registering an OAuth integration in Airtable. Each user authorizes access to the bases they choose, within gran...

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [MCP (OAuth) · Link Account](https://docs.stackone.com/connectors/airtable/guides/link-account/mcp-oauth.md)

> [card] [Personal Access Token · Link Account](https://docs.stackone.com/connectors/airtable/guides/link-account/personal-access-token.md)

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/airtable/guides/link-account/oauth-2-0.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

MCP (OAuth)

OAuth 2.0

Personal Access Token

No auth methods found

Scopes

Select all
|
Clear

data.recordComments:read

data.recordComments:write

data.records:read

data.records:write

enterprise.scim.usersAndGroups:manage

schema.bases:read

schema.bases:write

user.email:read

webhook:manage

workspacesAndBases:read

No scopes found

90 actions

ActionDescriptionRequired scopes

List Bases`airtable_list_bases`

Lists all bases the user has access to.

`schema.bases:read`

Create Base`airtable_create_base`

Creates a new base in a workspace with tables and fields.

`schema.bases:write`

Get Base Schema`airtable_get_base_schema`

Retrieves the schema of tables in a base.

`schema.bases:read`

List Comments`airtable_list_comments`

Lists comments on a record.

`data.recordComments:read`

Create Comment`airtable_create_comment`

Creates a comment on a record.

`data.recordComments:write`

Update Comment`airtable_update_comment`

Updates an existing comment.

`data.recordComments:write`

Delete Comment`airtable_delete_comment`

Deletes a comment from a record.

`data.recordComments:write`

Create Field`airtable_create_field`

Creates a new field in a table.

`schema.bases:write`

Update Field`airtable_update_field`

Updates a field's name or description.

`schema.bases:write`

Get Unified Credentials`airtable_unified_get_me`

Get the current Airtable connection's unified credentials and identity.

List Unified Groups`airtable_unified_list_groups`

List unified groups in Airtable via the SCIM API.

`enterprise.scim.usersAndGroups:manage`

Get Unified Group`airtable_unified_get_group`

Get a unified Airtable group by ID via the SCIM API.

`enterprise.scim.usersAndGroups:manage`

List Unified Resource Types`airtable_unified_list_resource_types`

List unified resource types in Airtable.

`schema.bases:read``workspacesAndBases:read`

List Unified Resource Users`airtable_unified_list_resource_users`

List unified resource users in Airtable.

`schema.bases:read``workspacesAndBases:read`

List Unified Roles`airtable_unified_list_roles`

List unified roles in Airtable.

`schema.bases:read``workspacesAndBases:read`

Get Unified Role`airtable_unified_get_role`

Get a unified Airtable role by ID.

`schema.bases:read``workspacesAndBases:read`

List Unified Users`airtable_unified_list_users`

List unified users in Airtable via the SCIM API.

`enterprise.scim.usersAndGroups:manage`

Get Unified User`airtable_unified_get_user`

Get a unified Airtable user by ID via the SCIM API.

`enterprise.scim.usersAndGroups:manage`

Ping`airtable_ping`

Ping the MCP server to check if it is running

List Airtable Bases`airtable_mcp_list_bases`

Lists all bases that you have access to in your Airtable account. Use this to get the baseId of the base you want to use...

List Airtable Workspaces`airtable_list_workspaces`

Lists all workspaces the current user has access to, along with their permission level in each. No dependencies. This is...

Search For An Airtable Base`airtable_search_bases`

Searches for bases by name. This is useful when you need to find a specific base quickly by a partial name-based match....

Returns The Summary Of The Specified Base`airtable_list_tables_for_base`

Gets the summary of a specific base. This includes the schemas of all tables in the base, including field name and type....

Gets Table Schema For The Given Table IDs, Optionally Narrowed To Specific Field IDs`airtable_get_table_schema`

Gets the detailed schema information for specified tables and fields in a base. This returns the field ID, type, and con...

Fetch Records For Processing Or Analysis`airtable_list_records_for_table`

Lists records queried from an Airtable table. Do not assume baseId and tableId. Obtain these from search\_bases → list\_ta...

List Comments On An Airtable Record`airtable_list_record_comments`

Lists comments on a specific Airtable record, ordered from newest to oldest. Do not assume baseId, tableId, or recordId....

Create A Comment On An Airtable Record`airtable_create_record_comment`

Creates a comment on a specific Airtable record. Do not assume baseId, tableId, or recordId. Obtain these from search\_ba...

Creates New Records In An Airtable Table`airtable_create_records_for_table`

Creates new records in an Airtable table. To get baseId and tableId, use the search\_bases and list\_tables\_for\_base tools...

Updates Multiple Records In An Airtable Table`airtable_update_records_for_table`

Updates records in an Airtable table. The fields you specify will be updated, and all other fields will be left unchange...

Deletes Records From An Airtable Table`airtable_delete_records_for_table`

Deletes records from an Airtable table. To get record IDs, use the list\_records\_for\_table or search\_records tools first....

Reverts A Previous Airtable Mutation`airtable_revert_action`

Reverts a previous eligible Airtable mutation by performing the inverse write, using the actionId it returned. Record up...

Creates A New Airtable Base`airtable_mcp_create_base`

Creates a new Airtable base with the specified tables and fields. Requires a workspaceId. To find workspace IDs, use lis...

Creates A New Table In An Airtable Base`airtable_mcp_create_table`

Creates a new table in an Airtable base. To get baseId, use the search\_bases or list\_bases tools first. The first field...

Updates An Existing Table In An Airtable Base`airtable_mcp_update_table`

Updates an existing table's name and/or description in an Airtable base. To get baseId and tableId, use the search\_bases...

Update View`airtable_update_view`

Update properties of an existing non-form view. Configure Grid, Gallery, Kanban, Calendar, Timeline, and Gantt views. Li...

Delete A Table From An Airtable Base`airtable_delete_table`

Deletes an entire table from a base, including all of its records, fields, and views. Use list\_tables\_for\_base to find t...

Creates A New Field In An Airtable Table`airtable_mcp_create_field`

Creates a new field in an existing Airtable table. To get baseId and tableId, use the search\_bases and list\_tables\_for\_b...

Updates The Name, Description, And/or Options Of A Field In An Airtable Table`airtable_mcp_update_field`

Updates the name, description, and/or options of a field in an existing Airtable table. At least one of name, descriptio...

Fetch Records From An Interface Page`airtable_list_records_for_page`

Lists records from an interface page. Pages may display data from one table (simple pages) or multiple related tables (h...

List Interfaces And Pages In A Base`airtable_list_pages_for_base`

Lists all interfaces and their pages for a base. Returns metadata about each interface and the pages within it, includin...

List Views In A Table`airtable_list_views_for_table`

Lists the views in a table, returning each view's ID, name, and type. Use this to discover viewId values needed by other...

List Permission Sets In A Base`airtable_list_permission_sets`

Lists the permission sets configured for a base. A permission set is a named, reusable bundle of fine-grained access rul...

Get A Record From An Interface Page`airtable_get_record_for_page`

Gets a single record's details from an interface page element. Takes a navigation path with a root record and edges repr...

Submit A Form`airtable_submit_form`

Submits a form, creating a new record in the form's source table. Call get\_form\_schema first on the form's pageId to dis...

Get The Schema Of A Form Page`airtable_get_form_schema`

Returns the schema of a form page — its structure, not the submitted-record data. Returns the form's source table, submi...

Search Records In An Airtable Table`airtable_search_records`

Searches for records in a table using a free-text query. Uses an optimized full-text index that supports fuzzy matching...

Search Candidate Records For A Linked-record Field`airtable_search_candidate_linked_records`

Searches for records that are valid candidates for a linked-record (foreign-key) field, returning each candidate's recor...

Create An Interface`airtable_create_interface`

Creates a new interface within a base. Use list\_bases or search\_bases to find the appropriate baseId. If requested to do...

Delete An Interface`airtable_delete_interface`

Deletes an interface from a base, including all of its pages. The published version, if any, immediately stops being ava...

Create A Page`airtable_create_page`

Creates a new page. Pass interfaceId for interface pages; omit it for standalone pages such as "recordDetail". Supported...

Delete An Interface Page`airtable_delete_page`

Deletes a page from an interface, given its pageId. Standalone forms, and pages that have no published version yet, are...

Get The Current Layout Of An Interface Page's Working Draft`airtable_get_page_layout`

Returns the current layout of a page's working draft, including changes that are not published yet, close to the configu...

Edit An Interface Page Layout Or A Standalone Form`airtable_update_page`

Applies partial edits to an existing interface page's unpublished working draft. Publishing stays a separate step. Use t...

Get The Required Configuration For A Page Type`airtable_describe_page_type`

Returns the JSON schema for a page type config. Use describe\_page\_element to discover any element-specific config requir...

Get The Required Configuration For A Page Element Type`airtable_describe_page_element`

Returns the JSON schema for a page element of the specified type. The returned schema describes the element config withi...

Report Missing Capability`airtable_report_missing_capability`

Report something your Airtable tools can't do, so Airtable can prioritize building it. You MUST call this before telling...

List Connected External Accounts`airtable_list_external_accounts`

Lists the external accounts (integrations) accessible to the current user, including accounts they own and accounts shar...

List Secrets`airtable_list_secrets`

Lists the secrets accessible to the current user, including secrets they own and secrets shared with them via user group...

Fetch Input Options For An Automation Action Or Trigger`airtable_fetch_automation_input_data`

Fetches dynamic input options for an automation action or trigger's input field (e.g. Slack channels, Jira projects, cal...

Create An Automation`airtable_create_automation`

Creates and validates one automation in a base: a trigger plus ordered nodes — action nodes, `repeatingGroup` (run inner...

Update An Automation`airtable_update_automation`

Replaces the entire draft configuration (trigger, graph, name, description) of an existing automation. If the automation...

Delete An Automation`airtable_delete_automation`

Deletes an existing automation from a base. The automation must be off before it can be deleted. The target automation m...

Get Create Automation Instructions`airtable_get_create_automation_instructions`

Returns the full spec for create\_automation — expression language, wrappers, function catalog, trigger and action input...

List Automations`airtable_list_automations`

Lists automations in an Airtable base. Returns metadata about each automation including its ID, name, deployment status,...

List Automation Runs`airtable_list_automation_runs`

Lists past runs of a published automation, newest first, with the failing step and error category for any run that faile...

Get Automation Configuration`airtable_get_automation`

Gets the full configuration of a single automation in an Airtable base, including trigger configuration, action nodes wi...

Test An Automation Webhook Trigger`airtable_test_automation_webhook_trigger`

Re-runs the trigger test for a genericWebhookReceived automation and waits briefly for a newly captured payload schema....

Publish An Interface`airtable_publish_interface`

Publishes an interface, promoting each page's working draft to the live version that end users see. This includes any dr...

Publish A Standalone Form`airtable_publish_form`

Publishes a standalone form, making its working draft the live version people fill in. This includes any draft edits mad...

Analyze Table`airtable_analyze_table`

Run statistical operations (count, sum, average, min, max, etc.) on an Airtable table, optionally grouped by columns and...

Registers A New Custom Element To Use In An Airtable Interface`airtable_create_custom_element`

Creates a new Custom Element and returns a permanent blockId. The blockId will be used to identify the custom element wh...

Builds Custom Element Code And Creates A Block Release`airtable_build_custom_element`

Builds, validates, and bundles source code for a Custom Element into a block release. Caller is responsible for writing...

Updates Configuration On An Existing Custom Element Page Element`airtable_update_custom_element_config`

Updates the configuration of an existing Custom Element (block) page element. Use this when the block's visible fields n...

Returns Documentation For Writing Custom Element Code`airtable_get_custom_element_documentation`

Returns documentation for writing Airtable Custom Element source code. Check this before writing code for build\_custom\_e...

Gets Information About A Custom Element On A Page`airtable_describe_custom_element`

Retrieves source code and per-table page element configuration for a custom element. Use this to inspect a custom elemen...

List Records`airtable_list_records`

Lists records in a table with filtering and sorting options.

`data.records:read`

Get Record`airtable_get_record`

Retrieves a single record by ID.

`data.records:read`

Create Records`airtable_create_records`

Creates one or more records in a table.

`data.records:write`

Update Record`airtable_update_record`

Updates a single record (partial update).

`data.records:write`

Replace Record`airtable_replace_record`

Replaces a record (destructive update clearing unspecified fields).

`data.records:write`

Update Multiple Records`airtable_update_records`

Updates multiple records in a single request.

`data.records:write`

Delete Record`airtable_delete_record`

Deletes a single record from a table.

`data.records:write`

Create Table`airtable_create_table`

Creates a new table in a base.

`schema.bases:write`

Update Table`airtable_update_table`

Updates a table's name or description.

`schema.bases:write`

Get Current User`airtable_get_current_user`

Retrieves the authenticated user's ID and email address.

`user.email:read`

List Webhooks`airtable_list_webhooks`

Lists all webhooks registered for a base.

`webhook:manage`

Create Webhook`airtable_create_webhook`

Creates a new webhook for a base.

`webhook:manage`

Refresh Webhook`airtable_refresh_webhook`

Refreshes a webhook to extend its expiration time.

`webhook:manage`

Delete Webhook`airtable_delete_webhook`

Deletes a webhook from a base.

`webhook:manage`

List Webhook Payloads`airtable_list_webhook_payloads`

Lists payloads for a webhook.

`webhook:manage`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.