Skip to content
REST API · Bearer auth · MCP coming soon

Built for AI agents.

REST API across 10+ platforms. One API key unlocks posts, profiles, analytics, and webhooks. MCP server coming soon — join the waitlist.

Free tier · No card required · Upgrade when you need more

How it works

Up and running in minutes

01

Get an API key

Sign up free — no card required. Generate a key in Settings → API Keys in under 60 seconds.

Get API key
02

Make a request

Hit the REST API with curl, fetch, or requests. Bearer token auth — one header, done.

03

Your agent posts

Create posts, schedule content, pull analytics — all from your automation. Same pipeline as the dashboard.

Code examples

Create a post and schedule it

No SDK needed — just curl, fetch, or requests. Bearer token, one header.

# Schedule a post — single image, three platforms, future time.
# Idempotency-Key is optional but recommended: a duplicate retry
# inside 24h returns the original post instead of creating a second.
curl https://api.letspost.it/v1/posts \
  -H "Authorization: Bearer lp_live_xxx" \
  -H "Idempotency-Key: launch-2026-05-01" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prof_abc123",
    "content": "New drop 🔥 #launch",
    "mediaUrl": "https://cdn.example.com/drop.jpg",
    "platforms": ["tiktok", "instagram", "youtube"],
    "scheduledFor": "2026-05-01T10:00:00Z"
  }'

API reference

REST endpoints

All endpoints use bearer auth. Base URL: .../v1

Posts
GET/posts
POST/posts
GET/posts/:id
PATCH/posts/:id
DELETE/posts/:id
GET/posts/:id/metrics
Profiles
GET/profiles
POST/profiles
GET/profiles/:id
PATCH/profiles/:id
DELETE/profiles/:id
Connected Accounts
GET/platform/connections
GET/platform/connect/:platform
DELETE/platform/connections/:id
Analytics
GET/analytics/account-metrics
GET/analytics/post-metrics
API Keys
GET/api-keys
POST/api-keys
DELETE/api-keys/:id
Webhooks
GET/webhooks
POST/webhooks
DELETE/webhooks/:id
Auth & Billing
GET/auth/me
GET/auth/usage
GET/billing/status
GET/billing/plans
Status
GET/status/components
GET/status/incidents/active
Available now

MCP server — available now

The letspost.it MCP server ships as the @letspost/mcp npm package — drop it into Claude Desktop, Cursor, or any MCP-compatible client and schedule posts in conversation. Same encrypted token storage and retry pipeline as the REST API.

{
  "mcpServers": {
    "letspost": {
      "command": "npx",
      "args": ["-y", "@letspost/mcp"],
      "env": { "LETSPOST_KEY": "lp_live_xxx" }
    }
  }
}
Quit and reopen Claude Desktop after saving. The letspost tools show up in the 🛠️ menu.

Give your agent social superpowers

Free plan. No card required. API key ready in under a minute.

Free tier · No credit card