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

> Create a cross-post workflow with the PostOnce Public API.

Use workflows to turn one connected account into the source for one or more target accounts.

Optional `settings.content_filters` lets you restrict which future source posts are eligible by content type or hashtag rules.

```bash theme={null}
curl -s \
  -H "Authorization: Bearer po_live_xxxxx_xxxxx" \
  -H "Content-Type: application/json" \
  -X POST https://postonce.to/api/public/v1/workflows \
  -d '{
    "name": "Instagram to Facebook",
    "source_account_id": "source-account-id",
    "target_account_ids": ["target-account-id"],
    "is_active": true
  }'
```

## Plan limits

Workflow creation respects the same plan caps used by the dashboard.

If you exceed your workflow limit, the API returns:

```json theme={null}
{
  "error": {
    "code": "workflow_limit_reached",
    "message": "You have reached the maximum number of workflows for your plan."
  }
}
```