Guides/Export form submissions to CSV

Export form submissions to CSV

Your data as a CSV. For spreadsheets, pipelines, or backups.

Updated March 2026

You want your data in a spreadsheet. Or a database. Or a data pipeline. CSV gets you there. The export endpoint returns all submissions for a form as a CSV file. Headers match your field names. Builder ($9/mo) and above.

1. Create a form and collect some data

You need a form with at least one submission. Submit some test data if you are just trying it out.

# Create a form:
curl -X POST https://sutrena.com/api/forms \
  -H "Authorization: Bearer st_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"templateId": "contact"}'

# Submit test data:
curl -X POST https://sutrena.com/api/forms/frm_xyz789/submit \
  -H "Content-Type: application/json" \
  -d '{"name": "Alice", "email": "[email protected]", "message": "Hello!"}'

curl -X POST https://sutrena.com/api/forms/frm_xyz789/submit \
  -H "Content-Type: application/json" \
  -d '{"name": "Bob", "email": "[email protected]", "message": "Question about pricing."}'

2. Export submissions as CSV

Call the export endpoint with your API key. CSV file with a Content-Disposition header. Save it with curl -o.

curl https://sutrena.com/api/forms/frm_xyz789/export \
  -H "Authorization: Bearer st_live_your_key" \
  -o contact-submissions.csv

# CSV contents:
# id,submitted_at,name,email,message
# sub_001,2026-03-01T10:00:00Z,Alice,[email protected],Hello!
# sub_002,2026-03-01T11:30:00Z,Bob,[email protected],Question about pricing.

3. Automate with a cron job or script

Set up daily or weekly exports for backups or a data pipeline. Each export returns all submissions -- a complete snapshot every time.

#!/bin/bash
# daily-export.sh - Run via cron: 0 6 * * * /path/to/daily-export.sh

DATE=$(date +%Y-%m-%d)
API_KEY="st_live_your_key"
FORM_ID="frm_xyz789"

curl -s "https://sutrena.com/api/forms/$FORM_ID/export" \
  -H "Authorization: Bearer $API_KEY" \
  -o "/backups/submissions-$DATE.csv"

echo "Exported submissions to /backups/submissions-$DATE.csv"

FAQ

Is CSV export available on the free plan?

No. Builder ($9/month), Pro ($29/month), and Scale ($79/month) only. On the free plan, you can still pull submissions via the JSON API.

What columns are included in the CSV?

An id column, a submitted_at timestamp, and one column per form field. Headers match the field names you defined.

Is there a limit on how many rows I can export?

No limit. You get all submissions. Large forms might take a few seconds.

Can I export only new submissions since the last export?

Not with the export endpoint -- it returns everything. For incremental exports, use the submissions list endpoint with pagination and track the last exported ID or timestamp.

Can I import the CSV into Google Sheets?

Yes. File > Import in Google Sheets, or automate it with the Google Sheets API.

Related

Submissions API →GDPR data deletion →Pipe CSV to Zapier →Plans with CSV export →

What is Sutrena?

Sutrena is the web runtime for AI agents. Three primitives — pages, forms, and dashboards — accessible through one API. Your agent creates web artifacts, humans interact with them, and your agent gets the data back. Framework-agnostic. Works from any MCP client or HTTP client.

Get started in two API calls

1. Get a trial key (no auth, no signup)

curl -X POST https://sutrena.com/api/trial

2. Create a form + dashboard from a template

curl -X POST https://sutrena.com/api/forms \
  -H "Authorization: Bearer st_trial_xxx" \
  -H "Content-Type: application/json" \
  -d '{"templateId": "waitlist", "createDashboard": true}'
/llms.txt/api/schema/llms-full.txt/.well-known/mcp.json

Ready to build?

Get a trial API key instantly with no signup, or create an account for the full experience.

Start buildingAgent docs
Export form submissions to CSV — Sutrena | Sutrena