Skip to main content

Post

idstring<uuid>
contentstring
statusstring

Possible values: [draft, scheduled, published]

account_idsinteger[]

Account IDs this post targets. Same name as the create-post request field — round-trip safe.

scheduled_forstring<date-time>nullable

UTC ISO 8601 when the post will publish (or did publish). Same name as the request field. Always Z-suffixed UTC.

timezonestring

IANA timezone for display. Defaults to "UTC".

media_idsstring<uuid>[]

Attached media IDs. Same name as the create-post request field.

mediaobject[]nullable

Hydrated media objects with full metadata (url, type, dimensions, etc.). For round-trip, use media_ids instead — it has the same names as the request field.

destinations object[]
  • Array [
  • idstring<uuid>
    platformstring
    statusstring
    account_namestringnullable
    account_idintegernullable
    published_atstring<date-time>nullable
    platform_post_idstringnullable
    errorstringnullable
    attemptsinteger
  • ]
  • created_atstring<date-time>

    When this post record was created (UTC). NOT the same as scheduled_for.

    updated_atstring<date-time>
    Post
    {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "content": "string",
    "status": "draft",
    "account_ids": [
    0
    ],
    "scheduled_for": "2024-07-29T15:51:28.071Z",
    "timezone": "string",
    "media_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    ],
    "media": [
    {}
    ],
    "destinations": [
    {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "platform": "string",
    "status": "string",
    "account_name": "string",
    "account_id": 0,
    "published_at": "2024-07-29T15:51:28.071Z",
    "platform_post_id": "string",
    "error": "string",
    "attempts": 0
    }
    ],
    "created_at": "2024-07-29T15:51:28.071Z",
    "updated_at": "2024-07-29T15:51:28.071Z"
    }