Introduction

• publish one post to multiple connected accounts
• schedule posts for later
• automate cross-post workflows between accounts
• manage posts and workflows programmatically from scripts, apps, and agents

​

Why use the PostOnce API

• One logical post can target many accounts. You send one post request and PostOnce handles the per-account fan-out.
• The API uses the same posting pipeline as the dashboard. Immediate and scheduled publishing both run through the same Trigger-backed delivery path.
• The API stays resource-focused. You work with accounts, media, posts, and workflows instead of low-level delivery records.

​

Base URL

https://postonce.to/api/public

​

Authentication

Authorization: Bearer po_live_xxxxx_xxxxx

​

Recommended workflow

1. List your connected accounts.
2. Upload media if you need a signed upload target.
3. Create a post or workflow.
4. Read the returned resource to inspect status and next actions.

​

Quick start

curl -s \
  -H "Authorization: Bearer po_live_xxxxx_xxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: launch-001" \
  -X POST https://postonce.to/api/public/v1/posts \
  -d '{
    "content": "Shipping the public API today.",
    "external_id": "launch-001",
    "targets": [
      { "account_id": "account-1" },
      { "account_id": "account-2" }
    ]
  }'

​

Next steps

• Start with Authentication
• Review Response format
• Learn the shared Data structures
• Review Rate limits
• Try Create your first post