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.
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. |
media_urls |
no | URLs públicas separadas con |. |
first_comment |
no | Primer comentario 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.
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.