Create a new folder to organize automations. Supports nested folders for hierarchical organization.

## Request Body

**`name`** string required

Folder name (1-255 characters)

**`description`** string optional

Optional folder description

**`parent_folder_id`** string optional

Parent folder ID for nesting (sfold_ prefixed). Null for root level.

**`display_order`** integer optional

Sort position (default: 0). Lower numbers appear first.

## Returns

Returns the created folder object.

Request

```bash cURL
curl -X POST "https://api.aitronos.com/api/v1/streamline/folders" \
  -H "X-API-Key: $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production Automations",
    "description": "All production-ready workflows",
    "display_order": 1
  }'
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.post(
    "https://api.aitronos.com/api/v1/streamline/folders",
    headers={"X-API-Key": api_key},
    json={
        "name": "Production Automations",
        "description": "All production-ready workflows",
        "display_order": 1
    }
)

folder = response.json()
print(f"Created folder: {folder['id']}")
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;

const response = await fetch(
  "https://api.aitronos.com/api/v1/streamline/folders",
  {
    method: "POST",
    headers: {
      "X-API-Key": apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      name: "Production Automations",
      description: "All production-ready workflows",
      display_order: 1
    })
  }
);

const folder = await response.json();
console.log(`Created folder: ${folder.id}`);
```

Response

```json 201 Created
{
  "id": "sfold_abc123",
  "organization_id": "org_xyz789",
  "created_by_user_id": "usr_def456",
  "parent_folder_id": null,
  "name": "Production Automations",
  "description": "All production-ready workflows",
  "display_order": 1,
  "is_deleted": false,
  "created_at": "2025-11-28T10:30:00Z",
  "updated_at": "2025-11-28T10:30:00Z",
  "deleted_at": null
}
```


```json 422 Unprocessable Entity
{
  "success": false,
  "error": {
    "code": "INVALID_FOLDER_NAME",
    "message": "Folder name must be between 1 and 255 characters",
    "status": 422
  }
}
```