Sign in
📝 Posts

Create a new social media post

Create a new social media post with simplified payload structure

post/api/v1/workspaces/{workspace_id}/posts

Path parameters

workspace_idstring required
Example:610a1e660cb41530ca40d372

Workspace ID

Request body

accountsstring[] required

Array of account IDs to post to (platform will be automatically detected). Optional if content_category_id is provided.

content_category_idstring

Optional content category ID. When provided, accounts from the category will be used. Can be combined with accounts array for merged unique accounts.

post_type'feed' | 'feed+reel' | 'reel' | 'carousel' | 'story' | 'feed+story' | 'feed+reel+story' | 'reel+story' | 'carousel+story' | 'video' | 'shorts' | 'poll'

Optional post type. See docs for platform-specific supported values. Defaults to 'feed' when omitted. For Facebook carousel posts you may set post_type='carousel', but you MUST also provide facebook_options.carousel.is_carousel_post=true with at least 2 cards — otherwise it is rejected with 400. For a LinkedIn poll set post_type='poll' and provide linkedin_options.poll (text-only); the poll is ignored for any other post_type.

post_video_titlestring

Optional video title for platforms that support it (YouTube, LinkedIn). Will be set in common_sharing_details video title, YouTube options, and LinkedIn options.

hide_clientboolean

Optional. When true, hides draft posts from client users. Ignored and stored as false for non-draft posts.

labelsstring[]

Optional array of label IDs to attach to the post. Maximum 20 labels. Must be valid label IDs for the workspace.

campaign_idstring nullable

Optional campaign (folder) ID to assign the post to. Must be a valid campaign ID for the workspace.

Example request

{
  "content": {
    "text": "Check out our latest product launch! ",
    "media": {
      "images": [
        "https://example.com/image1.jpg"
      ],
      "video": "https://example.com/video.mp4",
      "media_ids": [
        "625d06734ceb636c2f5e7743"
      ]
    }
  },
  "platform_overrides": {
    "facebook": {
      "content": {
        "text": "Facebook-specific caption 📘",
        "post_type": "story",
        "media": {
          "images": [
            "https://example.com/fb-image.jpg"
          ],
          "video": "https://example.com/fb-video.mp4"
        }
      }
    },
    "instagram": {
      "content": {
        "text": "IG-only caption 📸",
        "post_type": "reel",
        "media": {
          "images": [
            "https://example.com/ig-image.jpg"
          ],
          "video": "https://example.com/ig-video.mp4"
        }
      }
    },
    "tiktok": {
      "content": {
        "text": "TikTok-specific caption 🎵",
        "post_type": "carousel",
        "media": {
          "images": [
            "https://example.com/tt-image.jpg"
          ],
          "video": "https://example.com/tt-video.mp4"
        }
      }
    }
  },
  "accounts": [
    "BjniecijWv",
    "350830594784444",
    "17841453340834745"
  ],
  "content_category_id": "625d06734ceb636c2f5e7743",
  "post_type": "reel+story",
  "post_video_title": "My Amazing Video Title",
  "hide_client": true,
  "scheduling": {
    "publish_type": "scheduled",
    "scheduled_at": "2026-01-10 15:30:00"
  },
  "first_comment": {
    "message": "Great product! Check the details in comments.",
    "accounts": [
      "BjniecijWv",
      "350830594784444"
    ]
  },
  "gmb_options": {
    "topic_type": "EVENT",
    "start_date": "2026-01-10",
    "end_date": "2026-01-11",
    "title": "Special Event",
    "action_type": "BOOK",
    "cta_link": "https://example.com/book"
  },
  "youtube_options": {
    "title": "My Video Title",
    "privacy_status": "public",
    "category": "COMEDY",
    "tags": [
      "tutorial",
      "demo"
    ],
    "license": "youtube"
  },
  "tiktok_options": {
    "privacy_level": "PUBLIC_TO_EVERYONE"
  },
  "twitter_options": {
    "has_threaded_tweets": true,
    "threaded_tweets": [
      {
        "message": "Part 1 of the thread",
        "media": [
          "https://example.com/media.jpg"
        ]
      }
    ]
  },
  "threads_options": {
    "has_multi_threads": true,
    "multi_threads": [
      {
        "message": "Part 1 of the thread",
        "media": [
          "https://example.com/media.jpg"
        ]
      }
    ]
  },
  "pinterest_options": {
    "title": "My Pin Title",
    "link": "https://example.com/article"
  },
  "facebook_options": {
    "facebook_background_id": "106018623298955",
    "collaborators": [
      "1184502918080941"
    ],
    "carousel": {
      "is_carousel_post": true,
      "cards": [
        {
          "image": "https://example.com/card1.jpg",
          "title": "Card 1 Title",
          "description": "Short description shown under the title.",
          "link": "https://example.com/landing/1"
        }
      ],
      "accounts": [
        "610a1f880d9a55c41a4d3782"
      ],
      "call_to_action": "SHOP_NOW",
      "end_card": true,
      "end_card_url": "https://example.com"
    }
  },
  "instagram_options": {
    "collaborators": [
      "@nike"
    ],
    "trial_reel": {
      "enabled": true,
      "graduation_strategy": "SS_PERFORMANCE"
    }
  },
  "linkedin_options": {
    "title": "Q3 Product Highlights",
    "accounts": [
      "105256406"
    ],
    "poll": {
      "question": "Which framework do you prefer?",
      "options": [
        "Vue"
      ],
      "duration": "SEVEN_DAYS"
    }
  },
  "labels": [
    "625d06734ceb636c2f5e7743"
  ],
  "campaign_id": "625d06734ceb636c2f5e7743",
  "approval": {
    "approvers": [
      "627a078300a7d866600e7d02"
    ],
    "approve_option": "anyone",
    "notes": "Please review before publishing"
  },
  "approval_workflow": {
    "workflow_id": "66a1f2e4c8b9a1234567890d",
    "notes": "Please review before publishing"
  }
}

Response

Post created successfully

statusboolean
messagestring

Example response

{
  "status": true,
  "message": "Post created successfully. Use the returned `id` as `post_id` to update, delete, approve, or comment on this post.",
  "data": {
    "id": "66a1f2e4c8b9a1234567890a",
    "post_url": "https://example.com"
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.