Skip to main content
Build social publishing automations with the same engine that powers the PostOnce dashboard. Use the PostOnce Public API to:
  • 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.

​
What you can build

  • internal tooling for marketing and content teams
  • agent-driven publishing workflows
  • scheduled campaign publishing
  • cross-post automations between connected social accounts

​
Base URL

https://postonce.to/api/public
For local development: 
https://postonce.to/api/public

​
Authentication

All requests use a dashboard-generated API key: 
Authorization: Bearer po_live_xxxxx_xxxxx
See Authentication for scopes and plan access details.
  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 aggregate resource to inspect status, targets, and follow-up actions.

​
Quick start

Create a post that targets two connected accounts: 
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