---
title: Scheduled Post Object - API Response Reference
description: Field reference for the scheduled post object returned by the PostNitro Embed Schedule API, including captions, social accounts, design details, and status.
canonical: https://postnitro.ai/docs/embed/api/schedule/scheduled-post-object
---

# The scheduled-post object

This is the shape returned in `data` by [create](https://postnitro.ai/docs/embed/api/schedule/create-scheduled-post) and
[update](https://postnitro.ai/docs/embed/api/schedule/update-scheduled-post), in each element of the `data` array by
[list](https://postnitro.ai/docs/embed/api/schedule/list-scheduled-posts), and as `data` by [get](https://postnitro.ai/docs/embed/api/schedule/get-scheduled-post).

```jsonc
{
  "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](https://postnitro.ai/docs/embed/api/schedule/platform-settings).