Skip to main content
Publishing

Bulk CSV upload

Create many posts from a spreadsheet, with a per-row check before anything is created.

How it works

  1. Open Create Post or Calendar and choose Import CSV. Download the template.
  2. Fill one row per post and save as CSV (UTF-8). Maximum 1 MB and 500 rows.
  3. Upload the file. Each row is checked like a normal post (accounts, platform limits, media, options, time in the future). Nothing is created yet.
  4. Review the table, then confirm. Rows with errors can be skipped. Posts are created one by one through the normal post path, so roles, approvals and webhooks behave exactly as for single posts.
  5. A failed row never stops the others. The result lists what was created, failed and skipped, and Undo this import cancels or deletes the whole import (published posts stay).

Columns

ColumnMeaning
textPost text. Required unless the row has media.
scheduled_atIST date and time, 2026-12-01 09:30 or 01/12/2026 09:30 (ISO with offset also works). Empty means draft.
accountsAccount display names or platform names separated by ; or |. Use the display name when a platform has several accounts.
mediaLibrary media ids or library links, or public https image/MP4 URLs separated by ;. URLs are downloaded when you import (max 40 per file).
tagsUp to 8 tags separated by ;
campaignName of an existing campaign
platform_optionsJSON keyed by account or platform name, for example {"YouTube":{"title":"My video"}}

API

GET /api/imports/csv/template, POST /api/imports/csv/preview and POST /api/imports/csv take application_id, csv (the file text) and mode (schedule, draft or send_for_approval). Creating also needs confirm: true and optionally skip_invalid. The response carries an import_id; POST /api/posts/series/{import_id}/cancel undoes it. API keys with an hourly post limit count every created post.

v0.1.2

Bulk CSV upload | Documentation | Sociquza