Ingesting data — upload, paste, or webhook

The Ingest tab is where you submit data for processing. Three input modes are available.

Upload File:
• Drag a file onto the drop zone, or click to browse
• Supported formats: JSON, CSV, NDJSON, XML, plain text (.txt)
• After selecting a file, choose an output destination and an optional schema override, then click "Process Data"
• The file is processed immediately — results appear in a live panel below the button

Paste / Type:
• Paste any raw text directly into the editor
• Works with any format: JSON objects, CSV rows, log output, free-form text, XML fragments
• Useful for quick one-off transformations without saving a file

Via Webhook:
• Send a POST request to your org's webhook URL (configured in the Sources tab)
• Data submitted this way is processed automatically and appears in History
• The Ingest tab shows your webhook URL and usage examples when a token exists

Choosing a destination:
• "Local Download (browser)" — processed records download as a .jsonl file when the job completes
• Any saved destination (S3, GCS, SFTP, HTTP) — records are streamed there automatically

Schema override:
• Leave on "Auto-detect" to let Data Stream infer the structure from your data
• Or pick a saved schema to enforce a specific field set — useful when you process the same data format repeatedly