Skip to main content
POST
https://postonce.to/api/public
/
v1
/
posts
curl --request POST \ --url https://postonce.to/api/public/v1/posts \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "content": "Shipping the public API today.", "external_id": "launch-001", "targets": [ { "account_id": "account-1" }, { "account_id": "account-2", "content_override": "Shorter version for X" } ] } '
{
  "data": {
    "id": "<string>",
    "content": "<string>",
    "external_id": "<string>",
    "media": [
      {
        "url": "https://cdn.example.com/launch-image.png",
        "type": "image",
        "width": 123,
        "height": 123,
        "size": 123
      }
    ],
    "publish_at": "2023-11-07T05:31:56Z",
    "status": "scheduled",
    "created_at": "2023-11-07T05:31:56Z",
    "targets": [
      {
        "target_post_id": "<string>",
        "account_id": "<string>",
        "platform": "<string>",
        "username": "<string>",
        "status": "pending",
        "error": "<string>",
        "platform_post_id": "<string>",
        "platform_post_url": "<string>",
        "scheduled_time": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

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.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
targets
object[]
required
​
content
string
Example:

"Shipping the public API today."

​
external_id
string | null
Example:

"launch-001"

​
media
object[]
​
publish_at
string<date-time> | null
Example:

"2026-04-01T14:00:00.000Z"

Response

Post created successfully.

​
data
object