Automate content → media → scheduling with the Postly API
Build reliable automations that generate posts, upload images/videos, target the right connected accounts, and schedule across platforms. Use the API directly, run bulk workflows with Google Sheets, or connect no-code tools like n8n, Zapier, and Make.
Common integration blockers
Keep this page as a quick orientation. For implementation details, always follow the docs.
Posting to the wrong account? Use target_platforms.
UpdatedIn multi-account workspaces, you must explicitly pass the target account ID(s) via target_platforms when creating a post.
- Fetch connected accounts in your workspace and copy the account id you want.
- Create the post and pass that id in target_platforms.
Minimal example (verify fields in docs)
// Create post payload (example)
{
"workspace": "<workspaceId>",
"text": "Your caption",
"target_platforms": ["<connectedAccountId>"]
}Media missing? Upload to /files first, then reference the returned URL.
UpdatedCaptions can succeed while media fails if the media wasn’t uploaded and attached correctly. Upload the file, then use the returned files.postly.ai URL in media.
- Upload the image/video via POST /files (multipart/form-data).
- Use the returned data.url as media[].url when creating the post.
Minimal example (verify fields in docs)
// Create post payload (example)
{
"workspace": "<workspaceId>",
"text": "Your caption",
"media": [{ "url": "https://files.postly.ai/your-file.png", "type": "image/png" }],
"target_platforms": ["<connectedAccountId>"]
}Frequently Asked Questions
Where do I find the exact parameters and schema?
Always use the docs as the source of truth. The API is versioned and the documentation is kept up to date at docs.postly.ai.
What field do I use to target a specific account when creating a post?
Use target_platforms (array of connected account IDs). Fetch your workspace accounts first, then pass the chosen ID(s).
Why does my text publish but the image doesn’t show?
Upload the file via /files first, then use the returned files.postly.ai URL in the media array when calling /posts.
Do I have to use n8n/Zapier/Make?
No. API access is primary. No-code tools are optional orchestration layers if you want them.
Does this work with Google Sheets?
Yes. You can run bulk workflows with Google Sheets and connect it to Postly using native and API-driven flows.