API-first // early access — free to join

Your app posts.
One API.

One endpoint. X, Threads, and LinkedIn. Your code publishes — PostStash handles OAuth, rate limits, token refresh, and delivery.

POST /api/posts

// request

curl -X POST https://poststash.com/api/posts \
  -H "Authorization: Bearer ps_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["x"],
    "text": "Just shipped v2.0 — here's what changed",
    "schedule": "2025-03-10T14:00:00Z"
  }'

// response 200 OK

{
  "success": true,
  "post": {
    "id": "post_7f3a...",
    "status": "Ready",
    "platforms": ["x"],
    "schedule": "2025-03-10T14:00:00Z"
  }
}

// That's it. Bearer token auth. JSON in, post published.

## why_poststash

Building an app that posts to social is painful.

You need OAuth flows for each platform. Token refresh logic. Platform-specific character limits, media handling, and rate limit backoff. And you have to keep it running as APIs change.

PostStash takes all of that off your plate. One API key. One endpoint. Your code posts to X, Threads, and Instagram — without touching a single OAuth doc.

## how_it_works

Three steps to posting from code

01--get-key

Get an API key

Sign up, generate a ps_live_... key from your dashboard. Takes 30 seconds. No credit card needed.

02--post

Send a POST request

One endpoint. JSON body with platform, text, and an optional scheduled_at timestamp. Supports X, Threads, and Instagram in a single call.

03--done

We handle the rest

PostStash manages OAuth flows, platform-specific formatting, token refresh, rate limits, and delivery. Your code stays clean.

## code_examples

Works from anywhere you can make an HTTP request

Copy, paste, and ship. No SDK required.

curl — POST /api/posts
curl
 -X POST \
  https://poststash.com/api/posts \
  -H "Authorization: Bearer 
ps_live_abc123...
" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": 
["x"]
,
    "text": 
"Just shipped v2.0 — thread incoming"
,
    "schedule": 
"2025-03-10T14:00:00Z"
  }'

// Full OpenAPI docs at /docs/api — no login required to browse

## use_cases

What gets built on PostStash

Wherever you need to go from event to published post — PostStash is the layer in between.

AI Agents

Your agent posts autonomously

Wire up LangChain, CrewAI, OpenAI Assistants, or any custom agent. Agent reads content, writes a post, hits our API. Done — no human in the loop.

Newsletter → Social

New issue? Auto-post the insight

Subscribe to your own newsletter webhook. When a new issue drops, extract the key line and POST it to X and Threads — automatically, every time.

Blog → Social drip

Turn one post into a week of content

Parse a new blog article, generate a series of posts via your AI pipeline, and schedule them over 7 days. One API call per post. No copy-paste.

ATS → Social

New job listing, auto-posted

Connect your ATS webhook. New role opens → generate a post → POST to X and LinkedIn. Your employer brand runs on autopilot.

Reviews → Social proof

Great review? Share it instantly

Trigger on a 5-star review in Trustpilot, G2, or App Store. Format it, add context, and schedule it. Social proof without the manual work.

Built with PostStash

We dogfood it

Our own newsletter-to-social product is built entirely on the PostStash API. If it wasn't production-ready, we'd know.

## pricing

Simple pricing. No per-seat nonsense.

Pay for what you use. Every integration is unlocked on every plan.

Free
$0

Enough to build and test your integration.

100 posts / month
1 API key
X and Threads
Swagger docs access
No credit card needed
Start for free
Prorecommended
$19/ month

For production integrations and teams shipping at scale.

Unlimited posts
Multiple API keys
X, Threads, and Instagram
Multi-brand contexts
Post analytics
Priority support
Get Pro

// Early access users will be grandfathered at better terms if pricing changes.

## man poststash

Got questions?

// free to join — no credit card, no dashboard required

Get your API key in 30 seconds

Stop building OAuth flows. Start posting. Your code publishes — we handle the rest.