Create a custom request
Last updated
Last updated
Custom requests allow you to connect to any REST or GraphQL API directly in Airtable without writing code. You can configure the request URL, method, headers, body, authorization, pagination, and more using an interface similar to popular API clients like Postman or Insomnia.
Make sure you have Data Fetcher set up in your base:
and sign up for a free account.
On the Data Fetcher home screen, click Create your first request.
On the create request screen, under Application, select Custom.
Enter the complete request URL in the URL input field. You can find this in your target API's documentation - it consists of a base URL plus the specific endpoint path.
Example: To fetch cryptocurrency prices from the CoinGecko API, enter:
Pro tip: You can paste a cURL command directly into the URL input field, and Data Fetcher will automatically import all the settings.
Set up any additional options your API requires:
- Choose GET, POST, PUT, PATCH, DELETE, or HEAD
- Add query parameters to modify the API response
- Configure authentication (Bearer token, Basic auth, OAuth, etc.)
- Add custom headers required by your API
- Include request body data for POST, PUT, or PATCH requests
- Set up automatic handling of paginated responses
Enter a descriptive name for your request in the input field at the top of the screen.
Select your Output Table and View where the imported data should go. By default, this uses your current table and view.
Click Save & Run in the bottom right corner.
When you first run a request, the Response Field Mapping window opens. This is where you tell Data Fetcher how to match API response fields with your Airtable fields.
Field selection:
Click field names to select or deselect them for import
Only selected fields will be imported when the request runs
Field mapping:
Map each selected field to either an Existing field in your table or create a New field
Choose the appropriate field types for new fields
Once you're satisfied with the mapping, click Save & Run in the bottom right corner.
Your request will now execute and import data into your Airtable base. The imported data appears in your selected output table according to your field mapping configuration.
Future runs:
Click Run anytime to manually execute the request again
The field mapping persists, so subsequent runs import data automatically
Automation options: For hands-free data imports, you can set up automatic execution through:
- Import data at regular intervals
- Run based on changes in your Airtable base
- Execute via external systems
Data handling: Check out our guides on and to understand how new API data merges with existing records in your output table.