Published 2026-11-04
How to auto post to multiple social media platforms with one API call
Postwire is a multi-platform posting API that turns one request with your article, short post and images into a correctly fitted post on every platform.
Before you start
You need two things: something that writes the content (an AI agent, a Grok routine, or you), and the Postwire Chrome extension installed in a dedicated Chrome profile where you are logged into each platform. No X developer app, Meta app or platform API key is needed; those are optional and only used to pull metrics.
The steps
1. Create an API key on the AI access page (it starts with pwk_) and set it as an environment variable where your agent runs.
2. Write the package: package.json with the product and target platforms, long.md (the article), short.md (the short post) and one to three images.
3. Send it: one multipart POST to /api/v1/packages with the files. The response lists one variant per platform, each in the queued state.
4. Review: read each variant's text and approve it, or let your agent approve. On X the link goes into a self-reply; on Instagram it becomes 'link in bio'; on Reddit each subreddit has its own text.
5. Click publish: at each scheduled time the extension opens the filled post while your Mac is awake and you click publish. Each variant ends as published with a post URL, or failed with a reason.
Common mistakes
Sending the same text to every subreddit (Postwire rejects near-duplicates), expecting any platform to publish on its own (none does: you click publish), and forgetting that posts wait while the Mac sleeps. Re-sending the same package id is safe: it returns the original result instead of posting twice.
Frequently asked
- How long does one package take to post everywhere?
- Same-platform posts are spaced at least 30 minutes apart and each platform has a daily cap, so a package usually lands across platforms over a few hours rather than all at once.
- Do I need a tool for this?
- Not strictly: you can call each platform's API yourself. A tool saves you writing the per-platform rules, the scheduling, retries and the browser automation that fills every editor; it also saves you creating developer apps and paying for API access.
- What if it goes wrong?
- The variant moves to failed with a structured reason after up to three retries with back-off, and you can take over any post by hand.
Related
Try Postwire
Free tier, no credit card.