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. Pro ($29/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 '{"workflowId": "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. Pro ($29/month) and Scale ($99/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.

What is Sutrena?

Sutrena is the web runtime for AI agents. Forms, Pages, Analytics, Webhooks, Automations — all through 67 MCP tools and one REST API. Your agent creates web artifacts, humans interact with them, and your agent gets the data back. Use any one feature or all of them together.

Pages

Deploy HTML instantly

Forms

Collect structured data

Automations

DSL-based pipelines with 14 step types

Analytics

Privacy-first, no cookies

Webhooks

Slack, Discord, Telegram

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 anything — a page, form, automation, or analytics site

# Create a form
curl -X POST https://sutrena.com/api/forms \
  -H "Authorization: Bearer st_trial_xxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "waitlist", "fields": [{"name": "email", "label": "Email", "type": "email", "required": true}]}'

# Or deploy a page
curl -X POST https://sutrena.com/api/pages \
  -H "Authorization: Bearer st_trial_xxx" \
  -H "Content-Type: application/json" \
  -d '{"slug": "index", "title": "My Site", "html": "<h1>Live</h1>"}'

Ready to build?

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

Export form submissions to CSV — Sutrena | Sutrena