Create a Post

Creates and publishes or schedules a post to one or more connected social accounts.

POST /api/public/v1/posts

Request Headers

Header	Required	Value
`Authorization`	Yes	`Bearer YOUR_API_KEY`
`Content-Type`	Yes	`application/json`

Request Body

Parameter	Type	Required	Description
`content`	string	Yes	The post text content
`accounts`	string[]	Yes	Array of connected account IDs to post to (from List Accounts)
`type`	string	No	`"now"` (default) or `"schedule"`
`scheduledAt`	string	No	ISO 8601 datetime. Required when `type` is `"schedule"`.
`media`	array	No	Array of `{ url, filename? }` objects. Get `url` from Upload Media.
`pinterestBoardId`	string	No	Required when posting to a Pinterest account — the target board ID

Example Request — Publish Now

curl -X POST https://outstand.one/api/public/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "now",
    "content": "Excited to share our latest update! \ud83d\ude80",
    "accounts": ["account_id_1", "account_id_2"]
  }'

Example Request — Schedule for Later

curl -X POST https://outstand.one/api/public/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "schedule",
    "content": "Scheduled announcement",
    "accounts": ["account_id_1"],
    "scheduledAt": "2026-08-15T09:00:00Z",
    "media": [{ "url": "https://cdn.outstand.one/workspace-id/media/2026-08/abc123.jpg" }]
  }'

Response

{
  "success": true,
  "postId": "post_abc123",
  "message": "Post scheduled"
}

HTTP 201 on success. See Authentication for error responses (400, 401, 402, 502).