---
title: "Put CSV"
url: "https://help.flows.world/en/article/put-csv"
language: "en"
last_updated: "2025-12-16T19:02:56.849Z"
---

# Put CSV

Uploads a CSV file to your S3 storage bucket. Accepts raw CSV content as a string.

**Parameters**

| **Parameter** | **Required** | **Description** |
| --- | --- | --- |
| key | Yes | The path/filename to save the CSV file as (e.g., "reports/sales.csv") |
| csvPayload | Yes | The raw CSV content as a string |
| query | No | Optional query parameters |

**Example Payload**

{  
    "key": "reports/monthly-sales.csv",  
    "query": "",  
    "csvPayload": "id,name,email,status,created\_at\\n1,John Smith,john@example.com,active,2025-01-15\\n2,Jane Doe,jane@example.com,active,2025-02-20\\n3,Bob Wilson,bob@example.com,inactive,2025-03-10"  
}

**Response**

On success, returns:

-   data - Response from S3 (typically empty for successful PUT)
-   data.responseCode - HTTP status code (200 for success)

**CSV Format Tips**

-   Use \\n for line breaks when passing CSV as a JSON string
-   Ensure proper escaping of special characters (commas, quotes)
-   First row should contain column headers
-   The file will be uploaded with Content-Type: text/csv
