Social media APIOne API for every network you post to.
Posty’s social media API publishes to 11 networks with one request shape. Create a post with a version for each channel, send it through your workspace’s approval rule and schedule it, then read analytics and replies from the same API.
- Base URL
- https://api.posty.social
- Auth
- Bearer API keys, or OAuth for AI assistants
- Networks
- 11, one request shape
- Rate limits
- 600 reads and 120 writes a minute per key
- Retries
- Idempotency-Key on every POST
- Plans
- Growth and Accelerate
Schedule a post in three requests
Every request uses a Bearer API key created in Posty. Replace the ids with your own from the responses.
- 1
Find the channels
List the accounts connected to the workspace. Each one has an id you address posts to. An organization key also names the workspace with an X-Workspace-Id header.
List channelscurl https://api.posty.social/v1/channels \ -H "Authorization: Bearer $POSTY_API_KEY" - 2
Create the post
Create one post with the text for each channel, media you uploaded and the time it should go out. Each channel gets its own version, and Posty checks it against that network’s limits before it can publish.
Create a postcurl https://api.posty.social/v1/posts \ -H "Authorization: Bearer $POSTY_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: launch-post-1" \ -d '{ "scheduledAt": "2026-12-01T09:00:00Z", "content": [ { "channelId": "LINKEDIN_CHANNEL_ID", "body": "Our winter menu is here." }, { "channelId": "INSTAGRAM_CHANNEL_ID", "body": "Winter menu, out now.", "mediaIds": ["MEDIA_ID"] } ] }' - 3
Submit it
Submit it through the workspace’s approval rule. Once it is approved, publish with at set to scheduled to keep its time, or now to send it straight away.
Submit for approvalcurl https://api.posty.social/v1/posts/POST_ID/actions \ -H "Authorization: Bearer $POSTY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "action": "submit" }'
What else the API covers
The same API runs the rest of the workspace, so an integration can read results and answer replies as well as publish.
Posty API docs- Posts
- Create, edit and delete posts, submit them for approval, approve, publish, retry failed deliveries and read their history.
- Media
- Upload images and video to a temporary upload URL, set alt text and organise the library in folders.
- Channels
- List the connected accounts in a workspace and their status.
- Analytics
- Workspace overviews, audience figures and per-post metrics for the networks Posty collects analytics from.
- Inbox
- Read conversations and comment threads, reply and update their status.
- Campaigns
- Group posts into campaigns with objectives and personas, and read their results.
- Link in bio
- Edit a Link in Bio page’s blocks and read its analytics.
- Questionnaires
- Send client onboarding forms, collect the answers and apply them to the workspace.
The API follows your workspace rules
Keys are created in Posty by organization owners and admins, and every request goes through the same checks as the app.
Social media approval softwareApprovals still apply
Posts created through the API follow the same approval rule as posts made in the app. A post that needs approval cannot publish until it has it.
Keys are scoped
A key reaches one workspace or every workspace in the organization, chosen when it is created. New keys cannot change settings, members or connected accounts, or skip an approval.
Published rate limits
Each key gets 600 reads and 120 writes a minute, with rate limit headers on every response and Retry-After when a limit is reached, so a client knows when to try again.
Safe retries
Send an Idempotency-Key with a POST and a retried request returns the first response instead of creating a second post.
11 networks, one integration
Accounts are connected in Posty through each network’s own sign in. Your code names the channel, and Posty handles each network’s upload, format and limits.
What each network allowsQuestions about the API
- Is this a unified social media API?
- Yes, in that one request shape covers all 11 networks. You create one post with a version for each channel, and Posty handles each network’s upload and format. Accounts are connected in Posty through each network’s own sign in, so your code never handles their tokens.
- Can the social media scheduling API send posts for approval?
- Yes. Submit a post and it follows the workspace’s approval rule, and the same actions endpoint approves it or requests changes. A post that needs approval cannot publish until it has it.
- Does Posty have a LinkedIn posting API?
- Yes. A post can go to a LinkedIn Page or profile with text and one image or one video. LinkedIn is still in beta. Contact support and we'll see if we can turn it on for your workspace.
- Can I use it as an Instagram posting API?
- Yes, for professional accounts (Business or Creator), which are the only accounts Instagram’s own API publishes to. Posts created through the API publish the same way as posts made in the app.
- What does the social media posting API cost?
- API keys come with Growth and Accelerate, from $39 per workspace a month. Each key can make 600 reads and 120 writes a minute.
Other ways to connect
The API suits code you write and run. For workflow tools and AI assistants, Posty offers ready made connections over the same API.
- AI assistantsPosty MCPDraft, review and schedule from Claude, Codex or Cursor.
- AutomationPosty for n8nCreate, approve and publish posts from n8n workflows with the community node.
- ReferencePosty API docsEvery operation, parameter and response, by section.
- LimitsPlatform limitationsText, media and posting limits for each network, as the API enforces them.
Build on the workspace your team already uses
Create a workspace, connect its channels and add an API key on the API keys page. Then send your first request.
API keys come with Growth and Accelerate, from $39 per workspace a month. See pricing