Skip to main content
Import feedback as a file — no OAuth, no API key required.
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

​
Upload flow

1

Open CSV Upload

Go to Settings → Integrations and click Upload on the CSV Upload card.
2

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.
3

Map columns

Pick which column contains the feedback text. Optionally map timestamp, customer, and source columns. Preview rows are shown during mapping.
4

Confirm and process

Click Import. Hearflow queues the rows for AI extraction — you can close the tab and come back later.

​
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

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.
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.
The upload completed; processing continues in the background. The Imports tab shows progress and any rows that failed validation.
Files larger than 50 MB — Split the file into chunks or use a spreadsheet integration instead. Contact support if you have an ongoing need to ingest very large CSV batches.