Import feedback as a file — no OAuth, no API key required.Documentation Index
Fetch the complete documentation index at: https://docs.hearflow.io/llms.txt
Use this file to discover all available pages before exploring further.
Permissions — Members and owners can upload CSV files. Viewers have read-only access and cannot start a CSV upload; they will see a permission error if they try.
File format
| Property | Value |
|---|---|
| Encoding | UTF-8 |
| Delimiter | comma (auto-detected), semicolon, or tab |
| Header row | required |
| Size limit | 50 MB per file |
| Required columns | a free-text feedback column |
| Optional columns | timestamp, customer id or email, source / channel label |
Upload flow
Open CSV Upload
Go to Settings → Integrations and click Upload on the CSV Upload card.
Drag in your file
Drag-and-drop or select a CSV from your computer. Hearflow validates the encoding and header row client-side before starting the upload.
Map columns
Pick which column contains the feedback text. Optionally map timestamp, customer, and source columns. Preview rows are shown during mapping.
How It Works
Queued processing — Rows are processed in batches by background workers. No user action needed after upload. Processing time — Expect 1–5 minutes per thousand rows, depending on row length and AI budget. Re-upload safely — Hearflow deduplicates rows with identical content, so re-uploads will not create duplicate insights.Troubleshooting
"Could not parse file"
"Could not parse file"
Open the file in a text editor and confirm it starts with a header row. Save as UTF-8 if exporting from Excel — the default codepage often trips up parsing.
"No feedback column detected"
"No feedback column detected"
Make sure one column contains sentence-length text (roughly 20 characters or more). Tiny labels such as ratings or NPS scores are not enough on their own.
Upload stuck at 100%
Upload stuck at 100%
The upload completed; processing continues in the background. The Imports tab shows progress and any rows that failed validation.