# Publish

`POST https://wyroapi.com/v1/posts`

| Field | Type | Description |
| --- | --- | --- |
| `text` | string | Post text. Required. |
| `platforms` | string[] | Networks: `instagram`, `facebook`, `tiktok`, `linkedin`, `twitter`, `threads`, `youtube`, `pinterest`. Also accepts `ig`, `fb`, `x`, `yt`. |
| `account_ids` | string[] | Alternative to `platforms`: ids from `GET /v1/accounts`. |
| `media` | object[] | `[{"url": "https://...", "type": "image"}]`. Up to 10. The type is inferred from the extension. |
| `scheduled_at` | string | ISO 8601 date with time zone. Without it, the post goes out right away. |

## Rules per network

| Network | Text limit | Needs |
| --- | --- | --- |
| Instagram | 2200 | image or video |
| Facebook | 63206 | nothing |
| TikTok | 2200 | video |
| LinkedIn | 3000 | nothing |
| X | 280 | nothing |
| Threads | 500 | nothing |
| YouTube | 5000 | video |
| Pinterest | 500 | image or video |

## Example

```
curl -X POST https://wyroapi.com/v1/posts \
  -H "Authorization: Bearer $WYRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "We just launched something new 🚀",
    "platforms": ["instagram", "linkedin"],
    "media": [{"url": "https://picsum.photos/seed/demo/1080/1080"}],
    "scheduled_at": "2026-11-02T10:00:00-03:00"
  }'
```

## Response

```json
{
  "id": "post_…",
  "status": "scheduled",
  "simulated": true,
  "preview_url": "https://wyroapi.com/p/abc123xyz0",
  "targets": [{ "platform": "instagram", "preview_url": "…" }, { "platform": "linkedin", "preview_url": "…" }],
  "next_step": "Show the user the preview…"
}
```

Check the status with `GET /v1/posts/{id}`. To post to several networks at once, see [Post to multiple networks](https://wyroapi.com/en/docs/multiple-networks); to schedule, see [Scheduling posts](https://wyroapi.com/en/docs/scheduling).
