Posteady
Posteady Docs

Getting Started

Automate your social posting with the Posteady REST API and MCP server.

Automate your social posting on Threads and X through two interfaces:

  • REST API — authenticate with an API key. Best for scripts, servers, and your own automations.
  • MCP server — authenticate with OAuth 2.1. Best for AI clients like Claude and Cursor.

Both require the Creator plan or above.

REST APIMCP server
MechanismAPI keyOAuth 2.1
CredentialAuthorization: Bearer pk_...Access token (Bearer)
Best forScripts, servers, cron jobsAI clients (Claude, Cursor)
Auth guideREST authenticationMCP authentication

Your first call

The fastest way to start is the REST API. Create an API key in your Posteady settings, then publish a post:

curl -X POST https://www.posteady.com/api/v1/posts \
  -H "Authorization: Bearer pk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "accountIds": ["<account-uuid>"],
    "posts": [{ "text": "Hello from the Posteady API" }]
  }'

You can fetch your connected account IDs from GET /v1/accounts.

Next steps