Skip to content
PostyDashboardFinish setupGet started

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. 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 channels
    curl https://api.posty.social/v1/channels \
      -H "Authorization: Bearer $POSTY_API_KEY"
  2. 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 post
    curl 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. 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 approval
    curl 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 software
  • Approvals 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 allows

Questions 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.

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