Create post

Creates one logical post that can target multiple connected accounts. Include publish_at to schedule it instead of sending immediately.

post/v1/posts

Request

  • Base URL: https://postonce.to/api/public
  • URL: https://postonce.to/api/public/v1/posts
  • Auth: HTTP bearer

Request body

contentstring
external_idstring nullable
publish_atstring date-time nullable

Example request

{
  "content": "Shipping the public API today.",
  "external_id": "launch-001",
  "media": [
    {
      "url": "https://cdn.example.com/launch-image.png",
      "type": "image"
    }
  ],
  "publish_at": "2026-04-01T14:00:00.000Z"
}

Response

Post created successfully.

Example response

{
  "data": {
    "media": [
      {
        "url": "https://cdn.example.com/launch-image.png",
        "type": "image"
      }
    ],
    "status": "scheduled",
    "targets": [
      {
        "status": "pending"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.