Documentation
Impora Documentation
Guides, references, and answers for importing spreadsheet data into Airtable.
Getting started
Impora validates spreadsheet data before it is imported into Airtable. Connect your Airtable account, create a template, and define how incoming data should be handled.
Step-by-step guide
- 1
Connect Airtable
Connect the Airtable account that owns your base.
- 2
Create a template
Choose a base and table and save the structure.
- 3
Map your columns
Match spreadsheet headers to Airtable fields.
- 4
Validate before import
Review errors before submission.
- 5
Share or automate
Use links or connectors for repeat workflows.
Column mapping
Impora reads your Airtable field names and types automatically. Spreadsheet columns are matched by name where possible. You can override any mapping manually and save it as part of the template.
See how column mapping works when you import CSV into Airtable.
Validation rules
Every row is checked against your Airtable schema before import. Required fields, email formats, single select options, and linked record values are all validated. Errors are shown inline with clear descriptions so uploaders can fix issues before submitting.
This applies to all supported formats — learn more about Excel to Airtable imports.
Linked records
Impora resolves linked record values against existing records in your base. If a value matches an existing record, it is linked automatically. If no match is found, the row is flagged for review.
For a detailed walkthrough, see linked records import in Airtable.
Connectors
Connectors link Impora to cloud storage and email handoff channels. Once connected, files can be imported, exported, or roundtripped through saved Airtable templates. Supported channels: Google Drive, SharePoint, OneDrive, and Email Inbox.
Folder structure
Pick any folder in your connected cloud storage. Impora creates _processed and _errors subfolders automatically on the first run. You do not need to create them yourself.
Import mode
Files dropped in the watched folder are validated and imported. Successful files move to _processed. Failed files and error report CSVs go to _errors.
Your Folder/
└── incoming-data.csv
├── _processed/auto-created
└── data-2026-04-07.csv
├── _errors/auto-created
└── data_errors_17425.csv
Export mode
Each export deposits a timestamped CSV snapshot of your Airtable table or view. No subfolders are created.
Your Folder/
└── export-template-2026-04-07.csv
└── export-template-2026-04-06.csv
Roundtrip mode
Uses two separate folders. The inbox handles imports (with _processed and _errors). The outbox receives export snapshots. The two folders must be different.
Inbox/import folder
└── incoming-data.csv
└── _processed/
└── _errors/
Outbox/export folder
└── export-2026-04-07.csv
Automation modes
Connectors support import, export, webhook-triggered export, manual export, and roundtrip modes across cloud folders and email handoff where available.
Automatic import
Drop a CSV or Excel file into your connected folder. Impora detects it within seconds (via webhook) or within 15 minutes (via polling fallback), validates every row, and imports clean data. The file is then moved to the _processed or _errors subfolder.
Scheduled export
Set a daily, weekly, or custom-interval schedule in the Impora admin. At the configured time, Impora reads your Airtable table (or a filtered view) and delivers a timestamped CSV to the configured cloud folder or email recipients. Schedules are timezone-aware.
Webhook export (Airtable script)
Generate a secure webhook URL and secret in the Impora admin. Copy the pre-built script into an Airtable automation (Run a Script action). When the automation fires, it calls Impora, which exports data to the configured cloud folder or email recipients. This lets you trigger exports from your own Airtable logic: when a status changes, a checkbox is ticked, or any other Airtable trigger.
Manual export (Run Now)
Click Run Now in the Impora admin to export data to the connected folder or send it to email recipients on demand. Useful for one-off reports or testing your export setup before scheduling.
Roundtrip sync
Combines import and export using separated inbound and outbound lanes. Cloud folder roundtrip uses an inbox and outbox folder; email roundtrip accepts inbound files and sends outbound exports by schedule, webhook, or manual run.
Webhook export setup
Webhook exports let you trigger Airtable-to-cloud exports from Airtable automations. This is useful when you want exports driven by your own Airtable logic rather than a fixed schedule.
- 1
Configure a connector
Set the connector mode to Export or Roundtrip in the Impora admin.
- 2
Generate a webhook secret
In the connector settings, click Generate Webhook Secret. Copy the URL and secret. The secret is shown once and cannot be retrieved later.
- 3
Create an Airtable automation
In your Airtable base, create a new automation with your preferred trigger (e.g. when a record matches conditions).
- 4
Add a Run Script action
Paste the pre-built script from the Impora admin. Replace YOUR_SECRET_HERE with the secret you copied.
- 5
Test the automation
Run the automation manually in Airtable. Check your cloud folder for the exported CSV.
Airtable script template
Copy this script into your Airtable automation. Replace the URL and secret with the values from the Impora admin.
const TRIGGER_URL = 'https://app.impora.app/api/connectors/template/{templateId}/export-trigger';
const SECRET = 'YOUR_SECRET_HERE';
const response = await fetch(TRIGGER_URL, {
method: 'POST',
headers: {
'Authorization': `Bearer ${SECRET}`,
'Content-Type': 'application/json',
},
});
const body = await response.json();
if (!response.ok) {
throw new Error(`Export trigger failed: ${response.status}`);
}
console.log('Export triggered:', body);Frequently asked questions
Does Impora replace Airtable?
No. Impora sits in front of Airtable to validate and structure incoming data.
Can external users upload files?
Yes. Upload links can be shared without Airtable access.
What file types are supported?
CSV and Excel files.
Can I embed the upload form?
Yes. Available on Pro and Business plans.
What counts as a row?
Each record created or updated in Airtable counts as one row. Manual uploads allow up to 2,000 rows per file. Connector imports have separate per-run and monthly limits that vary by plan.
What if my file has more than 2,000 rows?
The 2,000-row limit applies to manual uploads only. Connect a cloud folder to import larger files. Connector imports handle up to 50,000 rows per run on Pro and 100,000 on Business.
What are connectors?
Connectors link Impora to cloud storage (Google Drive, SharePoint, OneDrive). Files in monitored folders are validated and imported automatically.
Do uploaders need an Airtable account?
No. Anyone with a shared upload link can submit data without an Airtable account or Impora login.
How are linked records handled?
Impora resolves linked record values against existing records in your base. Unmatched values are flagged for review before import.
Does Impora store uploaded data?
Uploaded files are processed and discarded after import. Data is never stored beyond what is needed to run the import.
Is there a free plan?
Yes. The free plan includes 1 base, 2 templates per base, and 2,000 rows per upload. No credit card required.
Troubleshooting
This section will grow as common issues are identified. If you run into a problem, contact us at [email protected] and we will help.
Contact support
Can't find what you need? Email us and we'll get back to you within 24 hours.
[email protected]