POST
/api/v2/postsposts:writeSchedule a post
Validates and schedules a post in one call.
The post goes on your PostWing calendar exactly like a dashboard post and publishes to every account at scheduled_at. To schedule several posts, call this once per post.
Request body
| Name | Type | Required | Description |
|---|---|---|---|
caption | string | Yes | Post text. "" for no caption. |
scheduled_at | ISO 8601 datetime | Yes | When to publish. Must be in the future. |
accounts | object[] | Yes | Where to post. Each item: { id, caption?, options? }. id comes from GET /accounts. |
accounts[].caption | string | null | No | Caption for this account only. Omit to use the post caption; "" for none on this account. |
accounts[].options | object | No | Settings for that account’s platform. See Platform options. |
media | object[] | No | Images or one video: { url, type?, cover? }. See Media. |
workspace_id | string (uuid) | No | Defaults to the workspace the accounts belong to. |
Request
curl -s -X POST "https://postwing.io/api/v2/posts" \
-H "Authorization: Bearer pw_live_…" \
-H "Content-Type: application/json" \
-d '{
"caption": "Launch day 🚀",
"scheduled_at": "2026-10-20T09:00:00Z",
"accounts": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
},
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"caption": "Launch day. Link in bio.",
"options": {
"who_can_reply": "following"
}
}
],
"media": [
{
"url": "https://cdn.example.com/launch.jpg"
}
]
}'Response (201)
{
"id": "7c1d2a8e-4b0f-4f8e-9a51-2f7f6b1c9d10",
"workspace_id": "3f2a9c1e-8d4b-4e6a-b2c7-1a9e5d3f7b20",
"status": "scheduled",
"caption": "Launch day 🚀",
"scheduled_at": "2026-10-20T09:00:00.000Z",
"media": [
{
"url": "https://cdn.example.com/launch.jpg",
"type": "image"
}
],
"accounts": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"platform": "instagram",
"handle": "brand",
"display_name": "Brand",
"caption": null,
"options": {},
"status": "scheduled",
"url": null,
"error": null
},
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"platform": "x",
"handle": "brand",
"display_name": "Brand",
"caption": "Launch day. Link in bio.",
"options": {
"who_can_reply": "following"
},
"status": "scheduled",
"url": null,
"error": null
}
],
"dashboard_url": "https://postwing.io/dashboard/post/7c1d2a8e-4b0f-4f8e-9a51-2f7f6b1c9d10",
"created_at": "2026-10-14T12:00:00.000Z",
"updated_at": "2026-10-14T12:00:00.000Z"
}