- Getting started with Airtable
- Introduction to Airtable basics
- Contacting Airtable Support Updated
- Airtable home screen
- Glossary of Airtable terminology
- Airtable technical requirements
- Feature differences between Airtable on desktop and mobile
- Airtable keyboard shortcuts
- Using Markdown in Airtable
- Adding descriptions in Airtable
- Finding Airtable IDs
- Airtable Automations
- Automations Overview
- Automation feature walkthroughs
- Integrated automation walkthroughs
- Airtable automation walkthroughs
- Linking existing records using automations
- Conditional groups of automation actions
- Repeating groups of Airtable automation actions
- Creating recurring records using automations
- How to delay Airtable automation runs
- Prevent automations from triggering by mistake
- Use automations to timestamp status updates
- Automation Triggers
- Airtable Triggers
- Airtable automation trigger: When record matches conditions
- Airtable automation trigger: When a form is submitted
- Airtable automation trigger: When record created
- Airtable automation trigger: When record updated
- Airtable automation trigger: When record enters view
- Airtable automation trigger: At scheduled time
- Airtable automation trigger: When webhook received
- Airtable automation trigger: When a button is clicked
- Airtable automation trigger: When email received Updated
- Integrated Triggers
- Airtable Triggers
- Automation Actions
- Airtable Actions
- Airtable automation action: Send email Updated
- Airtable automation action: Create record
- Airtable automation action: Update record
- Airtable automation action: Find records
- Airtable automation action: Sort list
- Airtable automation action: Run a script Updated
- Airtable automation action: Generate with AI
- Integrated Actions
- Airtable automation actions: Slack
- Airtable automation actions: Google Workspace
- Airtable automation action: Send MS Teams message
- Airtable automation actions: Outlook
- Airtable automation actions: Jira Cloud
- Airtable automation actions: Jira Server / Data Center
- Airtable automation actions: Salesforce
- Airtable automation action: Create post in Facebook Pages
- Airtable automation actions: GitHub Issues
- Airtable automation action: Hootsuite post
- Airtable automation action: Send Twilio SMS
- Airtable Actions
- Airtable Bases
- Using Airtable Cobuilder
- Airtable bases overview
- Creating and managing Airtable bases
- Structuring bases in Airtable
- Moving bases between workspaces in Airtable
- Creating and managing tables in Airtable
- Creating Airtable base share links
- Importing third-party data into Airtable
- Using insights in Airtable
- Troubleshooting Airtable base performance
- Airtable Betas
- Collaborating in Airtable
- Airtable Enterprise Support
- General Enterprise information
- External badging in Airtable
- Using app library and components in Airtable Updated
- Ask an Expert beta overview
- European data residency at Airtable
- Airtable user groups overview
- Airtable Enterprise API
- Creating and managing data retention policies in Airtable
- eDiscovery APIs in Airtable
- Airtable and data loss prevention
- Accessing Enterprise audit logs in Airtable
- Set up Jira Server / Data Center to connect with Airtable
- Admin panel pages
- Airtable admin panel overview
- Users - Airtable enterprise admin panel
- Airtable admin panel user details
- Groups - Airtable admin panel
- Workspaces - Airtable Enterprise Admin Panel
- Bases - Airtable admin panel
- Interfaces - Airtable admin panel
- Data sets - Airtable admin panel
- Managed apps - Airtable admin panel
- Components - Airtable admin panel
- Reports - Airtable admin panel
- Settings - Airtable admin panel Updated
- Managing Enterprise organizations
- Managing Enterprise admins in admin panel
- Using Organizations
- Organization branding for apps in Airtable
- Enterprise Hub in Airtable
- Enterprise Hub: Org unit assignment with user groups Updated
- Deactivating, removing access, and reactivating users in the admin panel
- Managing user access to workspaces and bases
- Airtable Enterprise Key Management Updated
- Custom terms of use New
- Enterprise SSO
- General Enterprise information
- Airtable Extensions
- Airtable Fields
- Fields Overview
- Attachment
- Date-based fields
- Formula
- Getting Started with Formulas
- Formula Foundations
- The essentials of Airtable formulas
- Formula writing tips for beginners
- Troubleshooting formulas
- Basic calculations
- Conditional statements
- Logical arguments
- Working with dates
- Displaying DATETIME_FORMAT using the date field in Airtable
- Working with date functions in Airtable
- Calculating the difference between dates in Airtable
- Supported DATETIME_DIFF unit specifiers in Airtable
- Supported DATETIME_FORMAT format specifiers in Airtable
- Using the DATETIME_PARSE() formula in Airtable
- Working with timezones
- Record functions
- Text functions
- Numeric functions
- Common Solutions: Beginner
- Common Solutions: Intermediate
- Common Solutions: Advanced
- Long Text Field
- Linked Record Field
- Linking records in Airtable
- Limiting linked record selection to a view in Airtable
- Dynamic filtering in linked record fields
- Linking to one, many, or a subset of Airtable records
- Converting existing fields to Airtable linked records
- Reordering record links in Airtable
- Understanding linked record relationships in Airtable
- Number-Based Fields
- Other Fields
- Rollup, lookup, and count fields
- Select and user fields
- Integrating with Airtable
- API
- Getting started with Airtable's Web API
- Creating personal access tokens
- Airtable Webhooks API Overview
- Service accounts overview
- Airtable Web API - Using filterByFormula or sort parameters
- Airtable API Deprecation Guidelines
- Airtable API: Common troubleshooting
- Managing API call limits in Airtable
- URL length limitations for web API requests
- Integration services
- Third-party integrations via OAuth overview
- Troubleshooting disconnected OAuth integrations in Airtable
- Options for integrating with Airtable
- Third-party integrations - Common troubleshooting
- Low-code integrations - Common troubleshooting
- Integrating Airtable with external calendar applications
- Visualizing records from Airtable in Tableau
- Visualizing Airtable records in Microsoft Power BI & Power Query
- Integrating HubSpot with Airtable
- Using Zapier to integrate Airtable with other services
- Using Zapier's Multi-Step Zaps to find and update records
- Using IFTTT to integrate Airtable with other services
- Integrating with AWS Lambda & DynamoDB
- Developer tools
- API
- Airtable Interface Designer
- Interface Designer overview articles
- Interface layouts
- Interface elements
- Adding and removing elements in interfaces
- Adding layouts to interfaces
- Formatting elements in interfaces
- Interface element: Button
- Interface element: Calendar
- Interface element: Chart
- Interface element: Filter
- Interface element: Gallery
- Interface element: Grid
- Interface element: Kanban
- Interface element: Number
- Interface element: Record picker
- Interface element: Text
- Interface element: Timeline
- Learning and Resources
- Managing Airtable
- Airtable Policy
- Airtable Records
- Airtable Sync
- Airtable Views
- Airtable Workspaces
- Print
- Share
- DarkLight
- PDF
Airtable API Deprecation Guidelines
- Updated on 15 Jan 2025
- 3 Minutes to read
- Print
- Share
- DarkLight
- PDF
Airtable has many APIs that developers use to build customized software. As with any software, these APIs will evolve over time as we aim to make things better for our developers and community. With such evolution, there are times when components may need to be removed or improved. Our team strives to avoid breaking changes whenever possible, and these guidelines are written to make such cases easier to navigate. To minimize disruption to users' builds, our internal developers follow these guidelines when making breaking changes or deprecations.
Overview
These guidelines are for “breaking changes” or “deprecations” (explained in more detail below) made to any of the following surface areas:
Web API (Includes Enterprise and Webhooks API)
Private betas
Special cases
What do we mean by breaking change and deprecation?
There is some overlap between the terms “breaking change” and “deprecation." Below is a more detailed description of what we mean by the two:
Breaking change - A non-backward-compatible change to existing behavior. For example, changing the format of parameters to an existing function in the scripting extension or removing certain properties from the output of a Web API endpoint. Note that adding new data in a forwards-compatible way is not considered a breaking change (e.g. adding new keys and values to an object returned from an API endpoint).
Deprecation - A planned breaking change where functionality will be removed in the future. For example, the planned removal of a Web API endpoint or a helper function from the Blocks SDK is considered a deprecation.
How will we roll out deprecations?
We aim to give developers time to migrate over to the new API. Where possible, we will provide a gradual rollout and migration path rather than a direct removal or breaking change. In addition, when changing behavior, our goal will be to support both the old and new behaviors simultaneously for a period of time before completely removing the old API. We will include this period of time in our announcement for each specific deprecation or breaking change.
How much advance notice will we give?
While we will do our best to meet the timeframes below, we reserve the right to deprecate any API without notice.
Surface | Timeframe |
---|---|
Web API Enterprise API | 12 months |
Blocks SDK Blocks CLI | 6 months *Note: Unlike other areas, both the Blocks SDK and CLI are versioned, and breaking changes are only released as part of major versions. This timeline requirement is for changes independent of versioning (e.g. a change to the blocks model bridge that affects all custom apps independent of SDK version, or a change to our minimum supported SDK version). It is not a requirement to pre-announce new major versions. |
Scripting extension Automations scripts | 6 months |
Public Beta | 2 weeks |
Private Beta | We will determine the deprecation timeline for private beta features on a case-by-case basis. |
Special Cases | Case-by-case basis In special cases (e.g. urgent security/infrastructural reasons), we may need to move faster (or in some cases for major changes, slower) than the given timeline. |
Learn more about our deprecation process by reviewing our Developer Terms.
Where can I find out about upcoming changes?
We will do our best to communicate community changes via the following channels where applicable:
The "Upcoming Deprecations" section of this document.
Direct email outreach to affected users where possible.
The documentation and changelog (if it exists) for each feature.
The quarterly developer newsletter and Airtable Developers Twitter account.
For features that have a subforum on the community forum, we'll also make a post there.
Are there any exceptions to these guidelines?
No guideline can cover every possible situation. Our intent is to provide developers with insight and tools to mitigate disruptions to building with Airtable.
This is a living document and will evolve over time. While not every situation will fit neatly into these guidelines, our goal is always to find the best solution for our community and provide as much background and communication as possible. Airtable is committed to being a stable system that, as much as possible, never breaks for its users. Exceptions will generally be announced in all relevant release notes.
Note
For information about browser support & deprecation, see this support article that covers the technical requirements for using Airtable.
Upcoming Deprecations
No upcoming deprecations at this time
List of Past Deprecations
January 13th, 2025 - Audit Log V1 was deprecated in lieu of Audit Log V2.
February 1st, 2024 - API key deprecation
August 25th, 2022 - Beta Webhooks API (All existing beta-style webhook subscriptions will stop functioning. You will no longer receive notification pings and you will not be able to retrieve payloads.)
May 26th, 2022 - Beta Webhooks API (We will stop allowing the creation of new beta-style webhook subscriptions)