The scheduled-post object

This is the shape returned in data by create and update, in each element of the data array by list, and as data by get.


{
  "id": "cmqkvnhk50001v0qusiglvc8h",
  "designId": "gpmg7dl0t73tukqvbnrtoqw6",          // or null
  "labels": null,                                    // array of labels, or null
  "status": "SCHEDULED",                             // "DRAFT" | "SCHEDULED"
  "scheduledFor": "2026-06-20T10:00:00.000Z",        // ISO-8601 (sent as scheduledAt on the request)
  "publishedAt": null,                               // ISO-8601 once published, else null
  "errorMessage": null,                              // post-level publishing error, or null
 
  "postSettings": null,                              // reel video metadata, or null
  "instagramPostSettings": null,                     // or settings object
  "linkedinPostSettings": {                          // or null
    "postType": "document",
    "postTitle": "fsdfsdfds"
  },
  "tiktokPostSettings": null,                        // or settings object
  "threadsPostSettings": null,                       // or settings object
 
  "postContents": [
    {
      "platform": "common",                          // common | linkedin | instagram | tiktok | facebook | threads
      "text": "My draft caption",
      "hashtags": []                                 // extracted from the caption
    }
  ],
 
  "designDetails": {                                 // or null when no design is attached
    "id": "gpmg7dl0t73tukqvbnrtoqw6",
    "name": "FIFA's 2026 World Cup Will Print $10.9 Billion — Here's Who Gets What",
    "designType": "carousel",
    "source": "editor"
  },
 
  "socialAccounts": [
    {
      "socialAccountId": "cmqi7jyir0003v0m91hxnyyaq",
      "liveLink": null,                              // public URL once published, else null
      "errorMessage": null,                          // per-account publishing error, or null
      "status": "PENDING",                           // "DRAFT" | "PENDING" | ... (set by publishing pipeline)
      "publishedAt": null
    }
  ],
 
  "createdAt": "2026-06-19T12:00:38.309Z",
  "updatedAt": "2026-06-19T12:00:38.309Z"
}

Field notes

Field	Notes
`scheduledFor`	The scheduled time. On requests this is sent as `scheduledAt`; the response echoes it back as `scheduledFor`.
`postContents`	Array of stored caption rows. The request sends `postContent` as an object keyed by platform; the response returns this array.
`labels`	`null` or an array of labels attached to the post.
`publishedAt` / `errorMessage` (top level)	Post-level publishing outcome, populated by the publishing pipeline after scheduling.
`socialAccounts[].status`	`"DRAFT"` for drafts, `"PENDING"` on create/update; the publishing pipeline later sets published/failed values.
`designDetails`	A flattened summary of the attached design (`id`, `name`, `designType`, `source`), or `null`.
`organizationId` / `workspaceId` / `userId`	Not returned — these are resolved from your API key and kept server-side.

For the conditional *PostSettings shapes, see Platform settings & conditional rules.