---
title: "Create post"
method: POST
path: "/posts"
tags: ["Posts"]
---

# Create post

`POST /posts`

## Request

- Base URL: `https://api.woopsocial.com/v1`
- URL: `https://api.woopsocial.com/v1/posts`
- Auth: HTTP bearer

Creates a (parent) post with one or more social account (child) posts.

All referenced social accounts must belong to the same project.

The request is validated atomically. If any social account fails validation, the post is not created.

## Request body

- CreatePostRequest
  - `autoDeleteMediaAfterPublish` boolean: When true, all media referenced by this post is automatically deleted from the media library after all social account deliveries for the post have published successfully.
  - `content` PostContentItemInput[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is supported.
    - `media` PostContentMediaInput[]
      - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media).
      - `type` 'MEDIA_LIBRARY', required
    - `text` string: Text content for this thread item.
  - `retryPolicy` PostRetryPolicy: Automatically creates a scheduled retry post for each failed target. Successful targets are never copied. Known failures requiring user intervention, such as insufficient credits or disconnected accounts, are not automatically retried. If the platform published a post but its response was lost, retrying may produce a duplicate.
    - `delaySeconds` integer, required: Minimum wait after each failure before the retry is published.
    - `maxRetries` integer, required: Maximum automatic retries per target, excluding the original attempt.
  - `schedule` union, required: When the post should be published.
    - DraftPostSchedule
      - `type` 'DRAFT', required
    - PublishNowPostSchedule
      - `type` 'PUBLISH_NOW', required
    - ScheduleForLaterPostSchedule
      - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future.
      - `type` 'SCHEDULE_FOR_LATER', required
  - `socialAccounts` SocialAccountInput[], required: Social account targets for this post. All referenced social accounts must belong to the same project. Duplicate `socialAccountId` values are invalid.
    - union
      - FacebookInput
        - `platform` 'FACEBOOK', required: Identifies which social media platform this data structure targets.
        - `contentOverride` PostContentItemInput[]: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is supported.
          - `media` PostContentMediaInput[]
            - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media).
            - `type` 'MEDIA_LIBRARY', required
          - `text` string: Text content for this thread item.
        - `socialAccountId` string, required: Connected social account identifier.
        - `link` string
        - `locationId` string: Facebook place ID to attach to the post.
        - `postType` 'TEXT_ONLY' | 'IMAGE' | 'VIDEO' | 'REEL' | 'STORY', required
      - InstagramInput
        - `platform` 'INSTAGRAM', required: Identifies which social media platform this data structure targets.
        - `contentOverride` PostContentItemInput[]: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is supported.
          - `media` PostContentMediaInput[]
            - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media).
            - `type` 'MEDIA_LIBRARY', required
          - `text` string: Text content for this thread item.
        - `socialAccountId` string, required: Connected social account identifier.
        - `cover` PostContentMediaInput
          - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media).
          - `type` 'MEDIA_LIBRARY', required
        - `postType` 'POST' | 'REEL' | 'STORY', required
        - `trialParams` InstagramTrialParams
          - `graduationStrategy` 'MANUAL' | 'SS_PERFORMANCE', required: Controls how a Trial Reel graduates to followers. `MANUAL` leaves graduation to the user in Instagram. `SS_PERFORMANCE` lets Instagram graduate the Reel automatically based on its performance.
      - LinkedInInput
        - `platform` 'LINKEDIN', required: Identifies which social media platform this data structure targets.
        - `contentOverride` PostContentItemInput[]: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is supported.
          - `media` PostContentMediaInput[]
            - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media).
            - `type` 'MEDIA_LIBRARY', required
          - `text` string: Text content for this thread item.
        - `socialAccountId` string, required: Connected social account identifier.
        - `link` string: URL to publish as a LinkedIn link preview card.
      - LinkedInPagesInput
        - `platform` 'LINKEDIN_PAGES', required: Identifies which social media platform this data structure targets.
        - `contentOverride` PostContentItemInput[]: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is supported.
          - `media` PostContentMediaInput[]
            - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media).
            - `type` 'MEDIA_LIBRARY', required
          - `text` string: Text content for this thread item.
        - `socialAccountId` string, required: Connected social account identifier.
        - `link` string: URL to publish as a LinkedIn link preview card.
      - PinterestInput
        - `platform` 'PINTEREST', required: Identifies which social media platform this data structure targets.
        - `contentOverride` PostContentItemInput[]: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is supported.
          - `media` PostContentMediaInput[]
            - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media).
            - `type` 'MEDIA_LIBRARY', required
          - `text` string: Text content for this thread item.
        - `socialAccountId` string, required: Connected social account identifier.
        - `link` string: Destination URL to attach to the Pin.
        - `pinterestBoardId` string, required: Identifier of the board to pin to.
        - `title` string
      - ThreadsInput
        - `platform` 'THREADS', required: Identifies which social media platform this data structure targets.
        - `contentOverride` PostContentItemInput[]: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is supported.
          - `media` PostContentMediaInput[]
            - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media).
            - `type` 'MEDIA_LIBRARY', required
          - `text` string: Text content for this thread item.
        - `socialAccountId` string, required: Connected social account identifier.
      - TikTokInput
        - `platform` 'TIKTOK', required: Identifies which social media platform this data structure targets.
        - `contentOverride` PostContentItemInput[]: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is supported.
          - `media` PostContentMediaInput[]
            - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media).
            - `type` 'MEDIA_LIBRARY', required
          - `text` string: Text content for this thread item.
        - `socialAccountId` string, required: Connected social account identifier.
        - `allowComment` boolean, required: Whether comments should be allowed for this TikTok post.
        - `allowDuet` boolean, required: Whether duets should be allowed for this TikTok post. This field applies to `postType=VIDEO`. When `postType=PHOTO`, this field is required by the API contract but is not used by TikTok.
        - `allowStitch` boolean, required: Whether stitches should be allowed for this TikTok post. This field applies to `postType=VIDEO`. When `postType=PHOTO`, this field is required by the API contract but is not used by TikTok.
        - `autoAddMusic` boolean, required: Whether TikTok should automatically add music to this post. This field applies to `postType=PHOTO`. When `postType=VIDEO`, this field is required by the API contract but is not used by TikTok.
        - `cover` PostContentMediaInput
          - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media).
          - `type` 'MEDIA_LIBRARY', required
        - `isAiGeneratedContent` boolean: Whether the TikTok post contains AI-generated content. This field applies to video posts.
        - `isBrandedContent` boolean, required: Whether the post should be disclosed as branded content on TikTok.
        - `isYourBrand` boolean, required: Whether the post should be disclosed as "Your brand" content on TikTok.
        - `postMode` 'DIRECT_POST' | 'MEDIA_UPLOAD'
        - `postType` 'VIDEO' | 'PHOTO', required
        - `privacyLevel` 'PUBLIC_TO_EVERYONE' | 'SELF_ONLY' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR'
      - WoopTestInput: WoopTest is a sandbox platform for testing and debugging. Posts targeting `WOOPTEST` go through the full scheduling pipeline but are never published to any real social network.
        - `platform` 'WOOPTEST', required: Identifies which social media platform this data structure targets.
        - `contentOverride` PostContentItemInput[]: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is supported.
          - `media` PostContentMediaInput[]
            - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media).
            - `type` 'MEDIA_LIBRARY', required
          - `text` string: Text content for this thread item.
        - `socialAccountId` string, required: Connected social account identifier.
        - `shouldSucceed` boolean: Whether the simulated delivery should succeed or fail. Defaults to `true`. Set to `false` to simulate a delivery failure.
      - XInput
        - `platform` 'X', required: Identifies which social media platform this data structure targets.
        - `contentOverride` PostContentItemInput[]: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is supported.
          - `media` PostContentMediaInput[]
            - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media).
            - `type` 'MEDIA_LIBRARY', required
          - `text` string: Text content for this thread item.
        - `socialAccountId` string, required: Connected social account identifier.
      - YouTubeInput
        - `platform` 'YOUTUBE', required: Identifies which social media platform this data structure targets.
        - `contentOverride` PostContentItemInput[]: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is supported.
          - `media` PostContentMediaInput[]
            - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media).
            - `type` 'MEDIA_LIBRARY', required
          - `text` string: Text content for this thread item.
        - `socialAccountId` string, required: Connected social account identifier.
        - `category` string
        - `madeForKids` boolean
        - `privacy` 'public' | 'private' | 'unlisted', required
        - `tags` string[]
        - `title` string, required

## Response `201`

Post created.

- Post
  - `autoDeleteMediaAfterPublish` boolean, required: Whether media auto-delete-after-publish is enabled for this post.
  - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned.
    - `media` PostContentMedia[]
      - `mediaId` string, required: Media identifier from the media library.
      - `mediaType` 'IMAGE' | 'VIDEO', required
      - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item.
      - `type` 'MEDIA_LIBRARY', required
      - `url` string, uri, required: Canonical media URL.
    - `text` string: Text content for this thread item.
  - `createdAt` string, date-time, required: UTC time when the post was created.
  - `id` string, required: Post identifier.
  - `projectId` string, required: Project identifier that the selected social accounts belong to.
  - `retryPolicy` PostRetryPolicy: Automatically creates a scheduled retry post for each failed target. Successful targets are never copied. Known failures requiring user intervention, such as insufficient credits or disconnected accounts, are not automatically retried. If the platform published a post but its response was lost, retrying may produce a duplicate.
    - `delaySeconds` integer, required: Minimum wait after each failure before the retry is published.
    - `maxRetries` integer, required: Maximum automatic retries per target, excluding the original attempt.
  - `schedule` union, required: When the post should be published.
    - DraftPostSchedule
      - `type` 'DRAFT', required
    - PublishNowPostSchedule
      - `type` 'PUBLISH_NOW', required
    - ScheduleForLaterPostSchedule
      - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future.
      - `type` 'SCHEDULE_FOR_LATER', required
  - `socialAccountPosts` SocialAccountPost[], required: Platform-specific post instances.
    - union
      - PinterestPost
        - `platform` 'PINTEREST', required: Identifies which social media platform this data structure targets.
        - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported.
          - `clicks` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `comments` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `engagementRate` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `impressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `likes` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `reactions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `saves` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `shares` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `uniqueImpressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `views` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
        - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned.
          - `media` PostContentMedia[]
            - `mediaId` string, required: Media identifier from the media library.
            - `mediaType` 'IMAGE' | 'VIDEO', required
            - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item.
            - `type` 'MEDIA_LIBRARY', required
            - `url` string, uri, required: Canonical media URL.
          - `text` string: Text content for this thread item.
        - `createdAt` string, date-time, required: UTC time when the social account post was created.
        - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values.
        - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully.
        - `errorMessage` string
        - `externalPostId` string
        - `externalPostUrl` string, uri
        - `postId` string, required: Parent post identifier.
        - `projectId` string, required: Project identifier.
        - `schedule` union, required: When the post should be published.
          - DraftPostSchedule
            - `type` 'DRAFT', required
          - PublishNowPostSchedule
            - `type` 'PUBLISH_NOW', required
          - ScheduleForLaterPostSchedule
            - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future.
            - `type` 'SCHEDULE_FOR_LATER', required
        - `socialAccountId` string, required: Connected social account identifier.
        - `socialAccountPostId` string, required: Social account post identifier.
        - `updatedAt` string, date-time, required: UTC time when the social account post was last updated.
        - `link` string: Destination URL to attach to the Pin.
        - `pinterestBoardId` string, required: Identifier of the board to pin to.
        - `title` string
      - InstagramPost
        - `platform` 'INSTAGRAM', required: Identifies which social media platform this data structure targets.
        - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported.
          - `clicks` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `comments` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `engagementRate` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `impressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `likes` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `reactions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `saves` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `shares` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `uniqueImpressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `views` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
        - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned.
          - `media` PostContentMedia[]
            - `mediaId` string, required: Media identifier from the media library.
            - `mediaType` 'IMAGE' | 'VIDEO', required
            - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item.
            - `type` 'MEDIA_LIBRARY', required
            - `url` string, uri, required: Canonical media URL.
          - `text` string: Text content for this thread item.
        - `createdAt` string, date-time, required: UTC time when the social account post was created.
        - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values.
        - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully.
        - `errorMessage` string
        - `externalPostId` string
        - `externalPostUrl` string, uri
        - `postId` string, required: Parent post identifier.
        - `projectId` string, required: Project identifier.
        - `schedule` union, required: When the post should be published.
          - DraftPostSchedule
            - `type` 'DRAFT', required
          - PublishNowPostSchedule
            - `type` 'PUBLISH_NOW', required
          - ScheduleForLaterPostSchedule
            - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future.
            - `type` 'SCHEDULE_FOR_LATER', required
        - `socialAccountId` string, required: Connected social account identifier.
        - `socialAccountPostId` string, required: Social account post identifier.
        - `updatedAt` string, date-time, required: UTC time when the social account post was last updated.
        - `cover` PostContentMediaInput
          - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media).
          - `type` 'MEDIA_LIBRARY', required
        - `postType` 'POST' | 'REEL' | 'STORY', required
        - `trialParams` InstagramTrialParams
          - `graduationStrategy` 'MANUAL' | 'SS_PERFORMANCE', required: Controls how a Trial Reel graduates to followers. `MANUAL` leaves graduation to the user in Instagram. `SS_PERFORMANCE` lets Instagram graduate the Reel automatically based on its performance.
      - FacebookPost
        - `platform` 'FACEBOOK', required: Identifies which social media platform this data structure targets.
        - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported.
          - `clicks` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `comments` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `engagementRate` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `impressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `likes` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `reactions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `saves` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `shares` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `uniqueImpressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `views` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
        - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned.
          - `media` PostContentMedia[]
            - `mediaId` string, required: Media identifier from the media library.
            - `mediaType` 'IMAGE' | 'VIDEO', required
            - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item.
            - `type` 'MEDIA_LIBRARY', required
            - `url` string, uri, required: Canonical media URL.
          - `text` string: Text content for this thread item.
        - `createdAt` string, date-time, required: UTC time when the social account post was created.
        - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values.
        - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully.
        - `errorMessage` string
        - `externalPostId` string
        - `externalPostUrl` string, uri
        - `postId` string, required: Parent post identifier.
        - `projectId` string, required: Project identifier.
        - `schedule` union, required: When the post should be published.
          - DraftPostSchedule
            - `type` 'DRAFT', required
          - PublishNowPostSchedule
            - `type` 'PUBLISH_NOW', required
          - ScheduleForLaterPostSchedule
            - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future.
            - `type` 'SCHEDULE_FOR_LATER', required
        - `socialAccountId` string, required: Connected social account identifier.
        - `socialAccountPostId` string, required: Social account post identifier.
        - `updatedAt` string, date-time, required: UTC time when the social account post was last updated.
        - `link` string
        - `locationId` string: Facebook place ID to attach to the post.
        - `postType` 'TEXT_ONLY' | 'IMAGE' | 'VIDEO' | 'REEL' | 'STORY', required
      - ThreadsPost
        - `platform` 'THREADS', required: Identifies which social media platform this data structure targets.
        - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported.
          - `clicks` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `comments` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `engagementRate` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `impressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `likes` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `reactions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `saves` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `shares` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `uniqueImpressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `views` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
        - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned.
          - `media` PostContentMedia[]
            - `mediaId` string, required: Media identifier from the media library.
            - `mediaType` 'IMAGE' | 'VIDEO', required
            - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item.
            - `type` 'MEDIA_LIBRARY', required
            - `url` string, uri, required: Canonical media URL.
          - `text` string: Text content for this thread item.
        - `createdAt` string, date-time, required: UTC time when the social account post was created.
        - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values.
        - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully.
        - `errorMessage` string
        - `externalPostId` string
        - `externalPostUrl` string, uri
        - `postId` string, required: Parent post identifier.
        - `projectId` string, required: Project identifier.
        - `schedule` union, required: When the post should be published.
          - DraftPostSchedule
            - `type` 'DRAFT', required
          - PublishNowPostSchedule
            - `type` 'PUBLISH_NOW', required
          - ScheduleForLaterPostSchedule
            - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future.
            - `type` 'SCHEDULE_FOR_LATER', required
        - `socialAccountId` string, required: Connected social account identifier.
        - `socialAccountPostId` string, required: Social account post identifier.
        - `updatedAt` string, date-time, required: UTC time when the social account post was last updated.
      - TikTokPost
        - `platform` 'TIKTOK', required: Identifies which social media platform this data structure targets.
        - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported.
          - `clicks` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `comments` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `engagementRate` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `impressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `likes` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `reactions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `saves` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `shares` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `uniqueImpressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `views` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
        - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned.
          - `media` PostContentMedia[]
            - `mediaId` string, required: Media identifier from the media library.
            - `mediaType` 'IMAGE' | 'VIDEO', required
            - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item.
            - `type` 'MEDIA_LIBRARY', required
            - `url` string, uri, required: Canonical media URL.
          - `text` string: Text content for this thread item.
        - `createdAt` string, date-time, required: UTC time when the social account post was created.
        - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values.
        - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully.
        - `errorMessage` string
        - `externalPostId` string
        - `externalPostUrl` string, uri
        - `postId` string, required: Parent post identifier.
        - `projectId` string, required: Project identifier.
        - `schedule` union, required: When the post should be published.
          - DraftPostSchedule
            - `type` 'DRAFT', required
          - PublishNowPostSchedule
            - `type` 'PUBLISH_NOW', required
          - ScheduleForLaterPostSchedule
            - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future.
            - `type` 'SCHEDULE_FOR_LATER', required
        - `socialAccountId` string, required: Connected social account identifier.
        - `socialAccountPostId` string, required: Social account post identifier.
        - `updatedAt` string, date-time, required: UTC time when the social account post was last updated.
        - `allowComment` boolean, required: Whether comments should be allowed for this TikTok post.
        - `allowDuet` boolean, required: Whether duets should be allowed for this TikTok post. This field applies to `postType=VIDEO`. When `postType=PHOTO`, this field is required by the API contract but is not used by TikTok.
        - `allowStitch` boolean, required: Whether stitches should be allowed for this TikTok post. This field applies to `postType=VIDEO`. When `postType=PHOTO`, this field is required by the API contract but is not used by TikTok.
        - `autoAddMusic` boolean, required: Whether TikTok should automatically add music to this post. This field applies to `postType=PHOTO`. When `postType=VIDEO`, this field is required by the API contract but is not used by TikTok.
        - `cover` PostContentMediaInput
          - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media).
          - `type` 'MEDIA_LIBRARY', required
        - `isAiGeneratedContent` boolean: Whether the TikTok post contains AI-generated content. This field applies to video posts.
        - `isBrandedContent` boolean, required: Whether the post should be disclosed as branded content on TikTok.
        - `isYourBrand` boolean, required: Whether the post should be disclosed as "Your brand" content on TikTok.
        - `postMode` 'DIRECT_POST' | 'MEDIA_UPLOAD'
        - `postType` 'VIDEO' | 'PHOTO', required
        - `privacyLevel` 'PUBLIC_TO_EVERYONE' | 'SELF_ONLY' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR'
      - YouTubePost
        - `platform` 'YOUTUBE', required: Identifies which social media platform this data structure targets.
        - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported.
          - `clicks` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `comments` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `engagementRate` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `impressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `likes` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `reactions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `saves` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `shares` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `uniqueImpressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `views` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
        - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned.
          - `media` PostContentMedia[]
            - `mediaId` string, required: Media identifier from the media library.
            - `mediaType` 'IMAGE' | 'VIDEO', required
            - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item.
            - `type` 'MEDIA_LIBRARY', required
            - `url` string, uri, required: Canonical media URL.
          - `text` string: Text content for this thread item.
        - `createdAt` string, date-time, required: UTC time when the social account post was created.
        - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values.
        - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully.
        - `errorMessage` string
        - `externalPostId` string
        - `externalPostUrl` string, uri
        - `postId` string, required: Parent post identifier.
        - `projectId` string, required: Project identifier.
        - `schedule` union, required: When the post should be published.
          - DraftPostSchedule
            - `type` 'DRAFT', required
          - PublishNowPostSchedule
            - `type` 'PUBLISH_NOW', required
          - ScheduleForLaterPostSchedule
            - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future.
            - `type` 'SCHEDULE_FOR_LATER', required
        - `socialAccountId` string, required: Connected social account identifier.
        - `socialAccountPostId` string, required: Social account post identifier.
        - `updatedAt` string, date-time, required: UTC time when the social account post was last updated.
        - `category` string
        - `madeForKids` boolean
        - `privacy` 'public' | 'private' | 'unlisted', required
        - `tags` string[]
        - `title` string, required
      - XPost
        - `platform` 'X', required: Identifies which social media platform this data structure targets.
        - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported.
          - `clicks` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `comments` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `engagementRate` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `impressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `likes` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `reactions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `saves` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `shares` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `uniqueImpressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `views` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
        - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned.
          - `media` PostContentMedia[]
            - `mediaId` string, required: Media identifier from the media library.
            - `mediaType` 'IMAGE' | 'VIDEO', required
            - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item.
            - `type` 'MEDIA_LIBRARY', required
            - `url` string, uri, required: Canonical media URL.
          - `text` string: Text content for this thread item.
        - `createdAt` string, date-time, required: UTC time when the social account post was created.
        - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values.
        - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully.
        - `errorMessage` string
        - `externalPostId` string
        - `externalPostUrl` string, uri
        - `postId` string, required: Parent post identifier.
        - `projectId` string, required: Project identifier.
        - `schedule` union, required: When the post should be published.
          - DraftPostSchedule
            - `type` 'DRAFT', required
          - PublishNowPostSchedule
            - `type` 'PUBLISH_NOW', required
          - ScheduleForLaterPostSchedule
            - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future.
            - `type` 'SCHEDULE_FOR_LATER', required
        - `socialAccountId` string, required: Connected social account identifier.
        - `socialAccountPostId` string, required: Social account post identifier.
        - `updatedAt` string, date-time, required: UTC time when the social account post was last updated.
      - LinkedInPost
        - `platform` 'LINKEDIN', required: Identifies which social media platform this data structure targets.
        - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported.
          - `clicks` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `comments` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `engagementRate` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `impressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `likes` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `reactions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `saves` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `shares` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `uniqueImpressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `views` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
        - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned.
          - `media` PostContentMedia[]
            - `mediaId` string, required: Media identifier from the media library.
            - `mediaType` 'IMAGE' | 'VIDEO', required
            - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item.
            - `type` 'MEDIA_LIBRARY', required
            - `url` string, uri, required: Canonical media URL.
          - `text` string: Text content for this thread item.
        - `createdAt` string, date-time, required: UTC time when the social account post was created.
        - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values.
        - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully.
        - `errorMessage` string
        - `externalPostId` string
        - `externalPostUrl` string, uri
        - `postId` string, required: Parent post identifier.
        - `projectId` string, required: Project identifier.
        - `schedule` union, required: When the post should be published.
          - DraftPostSchedule
            - `type` 'DRAFT', required
          - PublishNowPostSchedule
            - `type` 'PUBLISH_NOW', required
          - ScheduleForLaterPostSchedule
            - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future.
            - `type` 'SCHEDULE_FOR_LATER', required
        - `socialAccountId` string, required: Connected social account identifier.
        - `socialAccountPostId` string, required: Social account post identifier.
        - `updatedAt` string, date-time, required: UTC time when the social account post was last updated.
        - `link` string: URL to publish as a LinkedIn link preview card.
      - LinkedInPagesPost
        - `platform` 'LINKEDIN_PAGES', required: Identifies which social media platform this data structure targets.
        - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported.
          - `clicks` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `comments` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `engagementRate` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `impressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `likes` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `reactions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `saves` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `shares` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `uniqueImpressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `views` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
        - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned.
          - `media` PostContentMedia[]
            - `mediaId` string, required: Media identifier from the media library.
            - `mediaType` 'IMAGE' | 'VIDEO', required
            - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item.
            - `type` 'MEDIA_LIBRARY', required
            - `url` string, uri, required: Canonical media URL.
          - `text` string: Text content for this thread item.
        - `createdAt` string, date-time, required: UTC time when the social account post was created.
        - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values.
        - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully.
        - `errorMessage` string
        - `externalPostId` string
        - `externalPostUrl` string, uri
        - `postId` string, required: Parent post identifier.
        - `projectId` string, required: Project identifier.
        - `schedule` union, required: When the post should be published.
          - DraftPostSchedule
            - `type` 'DRAFT', required
          - PublishNowPostSchedule
            - `type` 'PUBLISH_NOW', required
          - ScheduleForLaterPostSchedule
            - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future.
            - `type` 'SCHEDULE_FOR_LATER', required
        - `socialAccountId` string, required: Connected social account identifier.
        - `socialAccountPostId` string, required: Social account post identifier.
        - `updatedAt` string, date-time, required: UTC time when the social account post was last updated.
        - `link` string: URL to publish as a LinkedIn link preview card.
      - WoopTestPost
        - `platform` 'WOOPTEST', required: Identifies which social media platform this data structure targets.
        - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported.
          - `clicks` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `comments` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `engagementRate` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `impressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `likes` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `reactions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `saves` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `shares` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `uniqueImpressions` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
          - `views` PostAnalyticsSnapshot[]
            - `collectedAt` string, date-time, required: UTC collection timestamp for this observation.
            - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred.
            - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate.
        - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned.
          - `media` PostContentMedia[]
            - `mediaId` string, required: Media identifier from the media library.
            - `mediaType` 'IMAGE' | 'VIDEO', required
            - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item.
            - `type` 'MEDIA_LIBRARY', required
            - `url` string, uri, required: Canonical media URL.
          - `text` string: Text content for this thread item.
        - `createdAt` string, date-time, required: UTC time when the social account post was created.
        - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values.
        - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully.
        - `errorMessage` string
        - `externalPostId` string
        - `externalPostUrl` string, uri
        - `postId` string, required: Parent post identifier.
        - `projectId` string, required: Project identifier.
        - `schedule` union, required: When the post should be published.
          - DraftPostSchedule
            - `type` 'DRAFT', required
          - PublishNowPostSchedule
            - `type` 'PUBLISH_NOW', required
          - ScheduleForLaterPostSchedule
            - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future.
            - `type` 'SCHEDULE_FOR_LATER', required
        - `socialAccountId` string, required: Connected social account identifier.
        - `socialAccountPostId` string, required: Social account post identifier.
        - `updatedAt` string, date-time, required: UTC time when the social account post was last updated.
        - `shouldSucceed` boolean: Whether the simulated delivery should succeed or fail. Defaults to `true`. Set to `false` to simulate a delivery failure.
  - `updatedAt` string, date-time, required: UTC time when the post was last updated.

## Other responses

- `422`: Request validation failed.
- `429`: Too many requests are already in progress for this API key.
- `500`: Internal server error.

---

[API](https://skmtc.dev/woopsocial/apis/woopsocial-api.md) · [All operations](https://skmtc.dev/woopsocial/apis/woopsocial-api/llms.txt) · [OpenAPI document](https://skmtc.dev/woopsocial/apis/woopsocial-api/revisions/578a984c20d9?raw)