wyro

CSV import

POST https://wyroapi.com/v1/posts/bulk creates one post per row of a CSV, each through the same path as POST /v1/posts (validation, duplicate guard, queue). Send the file with Content-Type: text/csv, or JSON {"csv": "…"}. Up to 200 rows and 1 MB. Download the template.

Columns

Column Required Description
text yes The post's text.
platforms one of the two Networks separated by |: instagram|linkedin.
account_ids one of the two Account ids separated by |.
scheduled_at no ISO 8601 with time zone (2026-12-01T10:00:00-03:00). Empty: publish now. queue: the next free slot of the queue.
media_urls no Public URLs separated by |.
first_comment no First comment where the network supports it.

Standard CSV: fields with commas, quotes or line breaks go in double quotes, and a quote inside is written twice (""). The first line is the header; a UTF-8 BOM (Excel) is fine. Unknown columns are an error, so a typo does not go unnoticed.

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. 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

Checks every row and creates nothing: { "dry_run": true, "total", "valid", "failed", "rows": [...] }. Each row has row, line (in the file), status (valid or error), the networks, scheduled_at (the queue slot it would take) and, on error, error.code, error.message and error.details. Duplicates inside the same file are caught too.

2. Create

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

Rows are independent: a row that fails does not stop the rest. Each row returns post_id and preview_url, or its error. With Idempotency-Key, row N uses the key <key>:row:N: sending the same file again with the same key creates nothing twice and returns the same results.

A file that is not valid CSV, has no text column or is too large fails as a whole (validation_error or bulk_too_large) before any row runs. With a test key, every row is simulated.

In the panel

Publicaciones → Import CSV: choose the file, check the preview with each row's errors, and confirm.