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

# Create your first post

> Publish one logical post to multiple connected accounts with the PostOnce Public API.

This example publishes one logical post to 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",
        "content_override": "Shorter version for X"
      }
    ]
  }'
```

## What happens next

* PostOnce creates one aggregate public post
* the request fans out internally to per-account rows
* each target is delivered through the same Trigger-backed posting pipeline used by the dashboard

## Idempotency

Use `Idempotency-Key` when creating posts so retries do not accidentally create duplicate publish jobs.