conecto. Get started
Forms

Export responses to CSV

forms_export_responses · Changes data · Markdown

Saves a CSV of a form's responses in the file store and returns a download link.

$0.001 a call

From your agent’s balance. A call that fails costs nothing.

An example

Put all the repair survey answers in a spreadsheet for me.

Your agent callsforms_export_responses$0.001 a call

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "form": "repair-feedback"
}
What comes back
{
  "file": {
    "file_id": "a6f6ad0d-ae36-4822-9768-ac9b96404568",
    "name": "repair-feedback-responses-2026-10-14.csv",
    "content_type": "text/csv",
    "size": "483 bytes",
    "size_bytes": 483,
    "sha256": "4ca1fd6542d6d8751f466c3e4cee2c8514f4b6a2e7800897d384ada1ed46d7ca",
    "created_at": "2026-10-14T08:00:00+00:00",
    "download_url": "https://cncto.co/d/a6f6ad0d-ae36-4822-9768-ac9b96404568?t=eyJmIjoiYTZmNmFkMGQtYWUzNi00ODIyLTk3NjgtYWM5Yjk2NDA0NTY4IiwiZXhwIjoxNzkyMTU4OTMyfQ:1xHLvg:kss90bAn1tZvO69r4DiO627ydQ5DceE_bacvLMtIAKk",
    "link_expires_in_hours": 24
  },
  "rows": 2
}

Use it when

The owner wants the responses in Excel, Numbers or Google Sheets.

What it does

A CSV file of a form's responses in the file store, with a download link: one row per response, oldest first, one column per field in form order, then the link values. Opens in Excel, Numbers and Google Sheets. With since, only responses from then on. Free when there is nothing to export.

What comes back

The CSV file with its file_id and download link, and how many rows; with nothing to export, a note and no file (free). Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
formRequiredstringThe form's form_id or slug (forms_list shows both). 1 to 60 characters.
sincestringOnly responses from this time on: ISO 8601 (2026-10-01T00:00:00Z) or a date (2026-10-01, UTC). Up to 40 characters.
link_hoursintegerHow long the download link works, in hours (up to 168, one week). 1 to 168. Default: 24.

The call

Over MCP, call forms_export_responses on https://api.conecto.chat/mcp/forms. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/forms_export_responses \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"form":"repair-feedback"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No form of the business has that form_id or slug.Call forms_list and use a form_id or slug from it.
invalid_input400since is not an ISO 8601 time or a date.Send a time like 2026-10-01T00:00:00Z or a date like 2026-10-01.
storage_full409The file store has no room for the CSV.Delete files with files_delete, or add room with files_add_storage.

More Forms tools

All 12 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md