Quickstart

1. Create an API key

In the dashboard: Settings → API keys → Create. Copy the op_… secret once.

2. Connect a social account

See Connection — dashboard or API OAuth. You will need each account’s id as connectionId when publishing.

3. Publish

curl -X POST https://api.onepostly.com/v1/posts \
  -H "x-api-key: op_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from Onepostly",
    "destinations": [
      { "connectionId": "YOUR_CONNECTION_ID" }
    ]
  }'

Response is 202 Accepted with status: "queued". Poll GET /v1/posts/:id until destinations are published or failed — or use webhooks instead of polling.

4. Check insights

curl "https://api.onepostly.com/v1/posts/POST_ID/insights" \
  -H "x-api-key: op_YOUR_KEY"

Wallet (X)

X usage is pass-through at X list prices (no markup). Debits come from your prepaid wallet — top up in Settings → Billing.
402 INSUFFICIENT_WALLET = empty Onepostly balance.