> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /folders

> Cree una nueva carpeta dentro de un profile.

## Endpoint

```
POST /v1/profiles/{profileId}/folders
```

## Solicitud

```bash theme={null}
curl -X POST "http://client-omni-api.argosidentity.com/v1/profiles/{profileId}/folders" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Supporting Documents"
  }'
```

### Cuerpo de la solicitud

<ResponseField name="name" type="string" required>
  Nombre visible de la carpeta
</ResponseField>

## Respuesta

```json theme={null}
{
  "success": true,
  "data": {
    "id": "fld_xyz789",
    "name": "Supporting Documents",
    "profileId": "pf_abc123def456",
    "isDefault": false,
    "createdAt": "2026-03-15T10:30:00Z"
  }
}
```

<Note>
  Cada profile comienza con una carpeta **default**. Puede crear carpetas adicionales para organizar distintos tipos de documento, por ejemplo `ID Documents` o `Financial Records`.
</Note>