POST/v1/posts/bulk-upload· 5 operations
Upload a spreadsheet, check every row, schedule them all.
Plan a month in a spreadsheet, upload the CSV, and run it as a dry run first. Pozy reports problems per row before a single post is created.
november.csv · dry run
| Row | Date | Platforms | Caption | Check |
|---|---|---|---|---|
| 2 | 2026-11-03 09:00 | Dark mode is here | Ready | |
| 3 | 2026-11-04 11:00 | A thread on how we built it… | Caption is 312 characters. X allows 280. | |
| 4 | 2026-11-05 17:00 | Desk setup ideas | Pinterest needs a boardId. | |
| 5 | 2026-11-06 12:00 | Friday giveaway | Ready | |
| 6 | 2026-11-08 10:00 | Shortcuts in 30 seconds | Ready |
3 ready · 2 to fix · nothing created yetExample
What you can do
Bulk scheduling, in detail.
- Dry run first
- Validate the whole file without creating anything. Fix the rows that fail, then upload again for real.
- Errors per row
- Each problem names the row, the column and the platform, such as a caption over the limit on X or a missing board on Pinterest.
- Character counts per platform
- The validate endpoints check caption length against each platform's limit before you schedule.
- Media by URL
- Point each row at an image or video URL. Pozy fetches it and prepares it for each platform.
- Works with the dashboard
- Upload from the dashboard or the API. The scheduled posts appear in the calendar either way.
The API
One request away.
Every Pozy feature is an API call first. The dashboard and the MCP server use the same endpoints you do.
Works with
POST /v1/posts/bulk-upload
curl https://api.pozy.ai/v1/posts/bulk-upload?dryRun=true \
-H "Authorization: Bearer $POZY_API_KEY" \
-F "file=@november.csv"Questions
Good to know.
What do I pay for bulk scheduling?
Every Pozy account includes it. You pay per connected account: the first 2 are free, then $6 each for accounts 3 to 10, $3 each for 11 to 100 and $1 each from 101, per month. On top of that: X API calls pass through at X's own rate with no markup: $0.015 per post and $0.20 for a post with a link, $0.005 per read. Every rate is on the pricing page.
Can my AI agent use this?
Yes. Everything here is available through the Pozy MCP server at https://mcp.pozy.ai/mcp, with the permissions you approve when you sign in.
Connect your first 2 accounts free.
No trial clock, every feature on, and no card unless you connect X. Add more accounts when you are ready.