# Importar CSV

`POST https://wyroapi.com/v1/posts/bulk` crea una publicación por fila de un CSV, cada una por el mismo camino que `POST /v1/posts` (validación, freno a duplicados, cola). Envía el archivo con `Content-Type: text/csv`, o JSON `{"csv": "…"}`. Hasta **200 filas** y **1 MB**. [Descarga la plantilla](https://wyroapi.com/csv/posts-template.csv).

## Columnas

| Columna | Obligatoria | Descripción |
| --- | --- | --- |
| `text` | sí | Texto del post. |
| `platforms` | una de las dos | Redes separadas con `\|`: `instagram\|linkedin`. |
| `account_ids` | una de las dos | Ids de cuenta separados con `\|`. |
| `scheduled_at` | no | ISO 8601 con zona horaria (`2026-12-01T10:00:00-03:00`). Vacío: se publica ya. `queue` (o `cola`): el próximo horario libre de la [cola](https://wyroapi.com/docs/cola). |
| `media_urls` | no | URLs públicas separadas con `\|`. |
| `first_comment` | no | [Primer comentario](https://wyroapi.com/docs/textos-por-red) donde la red lo admite. |

CSV estándar: los campos con comas, comillas o saltos de línea van entre comillas dobles, y una comilla adentro se escribe dos veces (`""`). La primera línea es el encabezado; un BOM UTF-8 (Excel) no molesta. Las columnas desconocidas dan error, para que un error de tipeo no pase desapercibido.

```csv
text,platforms,scheduled_at,media_urls,first_comment
"Lanzamos algo nuevo",instagram|linkedin,2026-12-01T10:00:00-03:00,https://example.com/a.jpg,"Link: https://example.com"
"Texto con comas, ""comillas"" y
dos líneas",linkedin|x,2026-12-02T19:00:00-03:00,,
"Al próximo horario libre",facebook,queue,,
```

## 1. Prueba (dry run)

```
curl -X POST "https://wyroapi.com/v1/posts/bulk?dry_run=true" -H "Authorization: Bearer $WYRO_API_KEY" \
  -H "Content-Type: text/csv" \
  --data-binary @posts.csv
```

Revisa cada fila y no crea nada: `{ "dry_run": true, "total", "valid", "failed", "rows": [...] }`. Cada fila trae `row`, `line` (en el archivo), `status` (`valid` o `error`), las redes, `scheduled_at` (el horario de la cola que tomaría) y, si falla, `error.code`, `error.message` y `error.details`. También detecta duplicados dentro del mismo archivo.

## 2. Crear

```
curl -X POST "https://wyroapi.com/v1/posts/bulk" -H "Authorization: Bearer $WYRO_API_KEY" \
  -H "Content-Type: text/csv" \
  -H "Idempotency-Key: 2f6c1d0a-campaign-december" \
  --data-binary @posts.csv
```

Las filas son independientes: una que falla no frena al resto. Cada fila devuelve `post_id` y `preview_url`, o su error. Con `Idempotency-Key`, la fila N usa la clave `<clave>:row:N`: volver a mandar el mismo archivo con la misma clave no crea nada dos veces y devuelve los mismos resultados.

Un archivo que no es CSV válido, no tiene columna `text` o es demasiado grande falla entero (`validation_error` o `bulk_too_large`) antes de correr ninguna fila. Con una clave de prueba, cada fila es simulada.

## En el panel

Publicaciones → **Importar CSV**: elige el archivo, revisa la vista previa con los errores de cada fila y confirma.
