CSV upload

Quick-start for the CSV upload connector.

In this demo build the CSV upload connector uses a recorded-fixture transport: payloads have the platform's public API shape, but nothing leaves the server and no credential exists.

At a glance

Connector id

csv

Kinds

catalogue

Capabilities

read catalogue, read inventory

Authentication

upload

Rate limits

Local file

Mechanism

Upload or SFTP/URL pull with a mapping UI (column -> field, transforms, unit parsing); saved mappings; scheduled pulls

Quick-start

1. Upload the file, or post it to the connections endpoint. Map columns to attributes; the mapping is saved for the next upload.
2. Run the first import. Records are staged first; review the validation summary and any conflicts with your own overrides.
3. Keep it current: re-import on a schedule or when the source changes.
4. Publish. Every projection is validated before it goes live.

curl -s https://app.fondaq.ai/v1/merchants/$MID/connections -H "Authorization: Bearer $AGORA_API_KEY" \
  -H "Agora-Version: 2026-10-25" -H "Idempotency-Key: connect-csv-001" -H 'Content-Type: application/json' \
  -d '{ "method": "csv" }'

Notes

Fallback for any stack

Source: connector registry (platform/connectors listConnectors())