Quickstart

From zero to a published post in three steps.

1. Get an API key

Open API in the app and create a key. Copy it — it’s shown once. See Authentication for scopes.

2. List your accounts

Publishing targets a specific connected account, so grab its id first.

list-accounts.shbash

curl -s "https://api.posteahora.com/functions/v1/api/accounts" \
  -H "Authorization: Bearer pah_live_xxxx"

3. Publish a post

Swap ACCOUNT_ID for an id from the previous step. Use status: "scheduled" with a future scheduledAt to schedule instead.

publish.shbash

curl -s -X POST "https://api.posteahora.com/functions/v1/api/posts" \
  -H "Authorization: Bearer pah_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Hello from the PosteAhora API 👋",
    "accountMappings": [{ "platform": "twitter", "accountId": "ACCOUNT_ID" }],
    "status": "published"
  }'

What’s next

Explore every endpoint in the API reference, or connect an AI agent via the MCP server and skip the code entirely.