> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postonce.to/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Get started with the PostOnce Public API.

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.

## Base URL

```text theme={null}
https://postonce.to/api/public
```

## Authentication

All requests use a dashboard-generated API key:

```http theme={null}
Authorization: Bearer po_live_xxxxx_xxxxx
```

See [Authentication](/getting-started/authentication) for scopes and plan access details.

## 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

Create a post that targets two connected accounts:

```bash theme={null}
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](/getting-started/authentication)
* Review [Response format](/getting-started/response-format)
* Learn the shared [Data structures](/getting-started/data-structures)
* Review [Rate limits](/getting-started/rate-limits)
* Try [Create your first post](/guides/create-your-first-post)