Use table values in requests
Last updated
Last updated
You can use values from your Airtable tables directly in your Data Fetcher requests. This creates dynamic requests that automatically pull data from your tables when they run, making your API integrations much more powerful and flexible.
Data Fetcher offers two ways to use table values:
- Executes a separate request for each record in a table or view. Perfect for bulk operations like looking up stock prices for every ticker symbol in your table or fetching details for every course ID.
- Runs one request using a value from a specific Airtable cell. Useful for dynamic values like current dates or storing API tokens in your base.
This method processes each record in a table or view individually, making it ideal for bulk data operations.
Click the + button in any compatible input field to open the table reference modal.
Select the Table and Field you want to reference from the dropdowns.
Under Run for every record in view, select the view containing the records you want to process. Do not select an individual record.
Click Confirm.
The input field will now contain a reference to your table and field. When the request runs, Data Fetcher will execute one request per record in the view, replacing the reference with each record's value. Each record processed counts as one run toward your monthly usage.
The Run on Multiple Records table and view are automatically set based on your selection, but you can modify these settings:
Click â–¶ Advanced settings to expand the advanced options.
Under Run on Multiple Records, select your desired table and view. The table must match the one referenced in your inputs.
Enable the If one of these records causes an error, run the next request anyway option to continue processing even when individual records fail.
For scheduled requests with this option enabled, Data Fetcher will pause the request if 100 consecutive records cause errors. You'll receive a notification so you can investigate and fix the issue.
This method pulls a value from one specific cell, perfect for dynamic values or configuration settings.
Click the + button in any compatible input field to open the table reference modal.
Select the Table and Field you want to reference.
Select the specific record containing the cell value you need.
Click Confirm.
The input field will display a reference to that cell. When the request runs, Data Fetcher replaces the reference with the actual cell value.
You can edit any table reference by clicking on it to reopen the table reference modal.
For values that change over time (like current dates), create Airtable formula fields and reference them using the single cell method.
Example: Using the current date and time
Let's create a dynamic timestamp in the format 2023-03-22 12:00:00.000
:
Create a new table in Airtable called "Config" to keep things organized.
Delete all records except one.
Create a formula field called "Date today" with this formula:
Create a single cell reference to this formula field in your request.
When your request runs (manually or automatically), Data Fetcher will use the current date and time value from the formula field.
When using table values in URLs, you may need to encode special characters. Data Fetcher can handle this automatically:
In the table reference modal, use the Encode URL table references option at the bottom to enable or disable automatic URL encoding for your reference.
This ensures that spaces, special characters, and other URL-incompatible values are properly formatted when used in request URLs.