--- title: "Create a new post." method: POST path: "/posts" tags: ["Posts"] --- # Create a new post. `POST /posts` ## Request - Base URL: `https://socialbu.com/api/v1` - URL: `https://socialbu.com/api/v1/posts` - Auth: HTTP bearer Creates a new post for one or more social media accounts. Each network has its own optional `options` object — refer to the network-specific request schemas below. To attach media, first upload it via `/upload_media` or `/upload_media_by_url` and include the returned `upload_token` in `existing_attachments`. This endpoint also supports a queue shortcut: - Send `queue_id` or `queue_ids` to save the post into one or more queues instead of creating scheduled posts. - In queue mode, the response only contains a confirmation message. ## Request body - union - FacebookPostRequest - `accounts` integer[], required: ID(s) of one or more social media accounts. - `team_id` integer: Team Id of social media account. - `publish_at` string, required: Format should be Y-m-d H:i:s (UTC) - `content` string: The content for the post. - `draft` boolean: Save the post as a draft - `queue_ids` integer[]: If provided, the post will be added to the specified queues. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. - `postback_url` string: Receive postback at this URL if needed. Sends a JSON POST request with parameters `post_id`, `account_id`, and `status` (created, published, failed). - `tags` integer[]: ID(s) of existing tags to apply to the post (maximum 10). Use `GET /tags` to list available tags and `POST /tags` to create new ones. Not supported together with `queue_id`/`queue_ids` — a queued post has no tag scope until it's actually published, so sending `tags` alongside either is rejected. - `options` object: Additional options for the post. - `comment` string: First comment for the post - `post_as_story` boolean: Set true to post the content as a story. Supported for posts having media attachment(s) - `post_as_reel` boolean: Set true to post the content as a reel. Supported for video posts only - `is_ai_generated` boolean: Disclose AI-generated Facebook Page videos, Reels, or video Stories. Does not label photo or text posts. - `video_title` string: Title for video attachment - `media_alt_text` string[]: Alternate text descriptions for each media item in the post. - `thumbnail` object: Add thumbnail (video post only) - `name` string: File name (e.g., "image.png"). - `mimeType` string: MIME type of the media (e.g., "image/png"). - `extension` string: File extension (e.g., png, mp4). - `key` string: Media key, received when uploading media using media upload endpoint. - `url` string: Media URL, received when uploading media using media upload endpoint. - `secureKey` string: Media secure key, received when uploading media using media upload endpoint. - `temporary` boolean: Media status, received when uploading media using media upload endpoint. - `_metaData` object: Information about media. - `width` integer: Width of the media. - `height` integer: Height of the media. - InstagramPostRequest - `accounts` integer[], required: ID(s) of one or more social media accounts. - `team_id` integer: Team Id of social media account. - `publish_at` string, required: Format should be Y-m-d H:i:s (UTC) - `content` string: The content for the post. - `draft` boolean: Save the post as a draft - `queue_ids` integer[]: If provided, the post will be added to the specified queues. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. - `postback_url` string: Receive postback at this URL if needed. Sends a JSON POST request with parameters `post_id`, `account_id`, and `status` (created, published, failed). - `tags` integer[]: ID(s) of existing tags to apply to the post (maximum 10). Use `GET /tags` to list available tags and `POST /tags` to create new ones. Not supported together with `queue_id`/`queue_ids` — a queued post has no tag scope until it's actually published, so sending `tags` alongside either is rejected. - `options` object: Additional options for the post. - `post_as_story` boolean: Set true to post the content as a story. Supported for posts having a media attachment - `share_reel_to_feed` boolean: Set true to share the reel to both Feed and the Reels tab. Set false or omit for Reels-tab-only publishing. Only applies to ordinary single-video reels, not stories, carousels, or trial reels. - `post_as_trial_reel` boolean: Set true to post the video as a Trial Reel. Trial Reels are shown to non-followers first and require a single-video post with at least 100 followers. Cannot be combined with `share_reel_to_feed`. - `trial_reel_graduation_strategy` boolean: Set true to automatically share the Trial Reel to your followers when it performs well (`SS_PERFORMANCE`). Set false (or omit) to keep it in trial mode until manually shared (`MANUAL`). Only applicable when `post_as_trial_reel` is true. - `comment` string: First comment for the post - `media_alt_text` string[]: Alternate text descriptions for each media item in the post. - `thumbnail` object: Add thumbnail (video post only) - `name` string: File name (e.g., "image.png"). - `mimeType` string: MIME type of the media (e.g., "image/png"). - `extension` string: File extension (e.g., png, mp4). - `key` string: Media key, received when uploading media using media upload endpoint. - `url` string: Media URL, received when uploading media using media upload endpoint. - `secureKey` string: Media secure key, received when uploading media using media upload endpoint. - `temporary` boolean: Media status, received when uploading media using media upload endpoint. - `_metaData` object: Information about media. - `width` integer: Width of the media. - `height` integer: Height of the media. - XPostRequest - `accounts` integer[], required: ID(s) of one or more social media accounts. - `team_id` integer: Team Id of social media account. - `publish_at` string, required: Format should be Y-m-d H:i:s (UTC) - `content` string: The content for the post. - `draft` boolean: Save the post as a draft - `queue_ids` integer[]: If provided, the post will be added to the specified queues. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. - `postback_url` string: Receive postback at this URL if needed. Sends a JSON POST request with parameters `post_id`, `account_id`, and `status` (created, published, failed). - `tags` integer[]: ID(s) of existing tags to apply to the post (maximum 10). Use `GET /tags` to list available tags and `POST /tags` to create new ones. Not supported together with `queue_id`/`queue_ids` — a queued post has no tag scope until it's actually published, so sending `tags` alongside either is rejected. - `options` object: Additional options for the post. - `media_alt_text` string[]: Alternate text descriptions for each media item in the post. - `threaded_replies` object[]: Threaded replies (thread posts). Each reply can have text and/or media. - `text` string: The text content of the threaded reply. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. - `made_with_ai` boolean: Set to true to disclose that the tweet contains AI-generated media. Only applies to the post (and any threaded replies) that have an attached image or video. - ThreadsPostRequest - `accounts` integer[], required: ID(s) of one or more social media accounts. - `team_id` integer: Team Id of social media account. - `publish_at` string, required: Format should be Y-m-d H:i:s (UTC) - `content` string: The content for the post. - `draft` boolean: Save the post as a draft - `queue_ids` integer[]: If provided, the post will be added to the specified queues. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. - `postback_url` string: Receive postback at this URL if needed. Sends a JSON POST request with parameters `post_id`, `account_id`, and `status` (created, published, failed). - `tags` integer[]: ID(s) of existing tags to apply to the post (maximum 10). Use `GET /tags` to list available tags and `POST /tags` to create new ones. Not supported together with `queue_id`/`queue_ids` — a queued post has no tag scope until it's actually published, so sending `tags` alongside either is rejected. - `options` object: Additional options for the post. - `reply_control` 'everyone' | 'accounts_you_follow' | 'mentioned_only': Who can reply to the post. - `threaded_replies` object[]: Threaded replies (thread posts). Each reply can have text and/or media. - `text` string: The text content of the threaded reply. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. - LinkedinPostRequest - `accounts` integer[], required: ID(s) of one or more social media accounts. - `team_id` integer: Team Id of social media account. - `publish_at` string, required: Format should be Y-m-d H:i:s (UTC) - `content` string: The content for the post. - `draft` boolean: Save the post as a draft - `queue_ids` integer[]: If provided, the post will be added to the specified queues. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. - `postback_url` string: Receive postback at this URL if needed. Sends a JSON POST request with parameters `post_id`, `account_id`, and `status` (created, published, failed). - `tags` integer[]: ID(s) of existing tags to apply to the post (maximum 10). Use `GET /tags` to list available tags and `POST /tags` to create new ones. Not supported together with `queue_id`/`queue_ids` — a queued post has no tag scope until it's actually published, so sending `tags` alongside either is rejected. - `options` object: Additional options for the post. - `link` string: Link for the post. - `trim_link_from_content` boolean: Trim the link from the content. - `customize_link` boolean: Set to true, if you want to custimze the link. - `link_description` string: Set custom link description when customize_link is set to true. - `link_title` string: Set custom link title when customize_link is set to true. - `media_alt_text` string[]: Alternate text descriptions for each media item in the post. - `video_thumbnail` object: Optional custom JPEG or PNG thumbnail for a post with exactly one supported video attachment, separate from the link thumbnail. Uses the media object returned by the media upload endpoint. If the thumbnail cannot be read or uploaded at publish time, the video is published without it. - `upload_token` string: Upload token returned by `/upload_media/status` or `/upload_media_by_url` for a newly uploaded thumbnail. - `key` string: Storage key returned for an already-saved thumbnail. - `temporary` boolean: Whether the uploaded media is temporary. - `thumbnail` object: Custom link thumbnail. - `name` string: File name (e.g., "image.png"). - `mimeType` string: MIME type of the media (e.g., "image/png"). - `extension` string: File extension (e.g., png, mp4). - `key` string: Media key, received when uploading media using media upload endpoint. - `url` string: Media URL, received when uploading media using media upload endpoint. - `secureKey` string: Media secure key, received when uploading media using media upload endpoint. - `temporary` boolean: Media status, received when uploading media using media upload endpoint. - `_metaData` object: Information about media. - `width` integer: Width of the media. - `height` integer: Height of the media. - `comment` string: First comment for the post. - `document_title` string, required: Custom document title. Required for posts having PDF, PPT, or Doc as an attachment. - RedditPostRequest - `accounts` integer[], required: ID(s) of one or more social media accounts. - `team_id` integer: Team Id of social media account. - `publish_at` string, required: Format should be Y-m-d H:i:s (UTC) - `content` string: The content for the post. - `draft` boolean: Save the post as a draft - `queue_ids` integer[]: If provided, the post will be added to the specified queues. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. - `postback_url` string: Receive postback at this URL if needed. Sends a JSON POST request with parameters `post_id`, `account_id`, and `status` (created, published, failed). - `tags` integer[]: ID(s) of existing tags to apply to the post (maximum 10). Use `GET /tags` to list available tags and `POST /tags` to create new ones. Not supported together with `queue_id`/`queue_ids` — a queued post has no tag scope until it's actually published, so sending `tags` alongside either is rejected. - `options` object: Additional options for the post. - `title` string, required: Title of the post - `is_spoiler` boolean: Mark the post as spoiler - `is_nsfw` boolean: Mark the post as NSFW - `flair_id` integer: Flair ID can be obtained from accounts' extra_data - `comment` string: First comment for your post. - MastodonPostRequest - `accounts` integer[], required: ID(s) of one or more social media accounts. - `team_id` integer: Team Id of social media account. - `publish_at` string, required: Format should be Y-m-d H:i:s (UTC) - `content` string: The content for the post. - `draft` boolean: Save the post as a draft - `queue_ids` integer[]: If provided, the post will be added to the specified queues. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. - `postback_url` string: Receive postback at this URL if needed. Sends a JSON POST request with parameters `post_id`, `account_id`, and `status` (created, published, failed). - `tags` integer[]: ID(s) of existing tags to apply to the post (maximum 10). Use `GET /tags` to list available tags and `POST /tags` to create new ones. Not supported together with `queue_id`/`queue_ids` — a queued post has no tag scope until it's actually published, so sending `tags` alongside either is rejected. - `options` object: Additional options for the post. - `mark_sensitive` boolean: Mark status and attached media as sensitive - `spoiler` string: Text to be shown as a warning or subject before the actual content - `media_alt_text` string[]: Alternate text descriptions for each media item in the post. - `threaded_replies` object[]: Threaded replies (thread posts). Each reply can have text and/or media. - `text` string: The text content of the threaded reply. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. - PinterestPostRequest - `accounts` integer[], required: ID(s) of one or more social media accounts. - `team_id` integer: Team Id of social media account. - `publish_at` string, required: Format should be Y-m-d H:i:s (UTC) - `content` string: The content for the post. - `draft` boolean: Save the post as a draft - `queue_ids` integer[]: If provided, the post will be added to the specified queues. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. - `postback_url` string: Receive postback at this URL if needed. Sends a JSON POST request with parameters `post_id`, `account_id`, and `status` (created, published, failed). - `tags` integer[]: ID(s) of existing tags to apply to the post (maximum 10). Use `GET /tags` to list available tags and `POST /tags` to create new ones. Not supported together with `queue_id`/`queue_ids` — a queued post has no tag scope until it's actually published, so sending `tags` alongside either is rejected. - `options` object: Additional options for the post. - `thumbnail` object, required: Supported for posts having video attachment. - `name` string: File name (e.g., "image.png"). - `mimeType` string: MIME type of the media (e.g., "image/png"). - `extension` string: File type (e.g., "png") - `key` string: Media key, received when uploading media using media upload endpoint. - `url` string: Media URL, received when uploading media using media upload endpoint. - `secureKey` string: Media secure, key received when uploading media using media upload endpoint. - `temporary` boolean: Media status, received when uploading media using media upload endpoint. - `_metaData` object: Information about media. - `width` integer: Width of the media. - `height` integer: Height of the media. - `pin_title` string: Title of the pin to be displayed on the board. - `board_name` string, required: Name of the board where the pin will be saved. - `media_alt_text` string[]: Alternate text descriptions for each media item in the post. - `pin_link` string: Target URL associated with the pin. - GoogleBusinessProfilePostRequest - `accounts` integer[], required: ID(s) of one or more social media accounts. - `team_id` integer: Team Id of social media account. - `publish_at` string, required: Format should be Y-m-d H:i:s (UTC) - `content` string: The content for the post. - `draft` boolean: Save the post as a draft - `queue_ids` integer[]: If provided, the post will be added to the specified queues. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. - `postback_url` string: Receive postback at this URL if needed. Sends a JSON POST request with parameters `post_id`, `account_id`, and `status` (created, published, failed). - `tags` integer[]: ID(s) of existing tags to apply to the post (maximum 10). Use `GET /tags` to list available tags and `POST /tags` to create new ones. Not supported together with `queue_id`/`queue_ids` — a queued post has no tag scope until it's actually published, so sending `tags` alongside either is rejected. - `options` object: Additional options for the post. - `topic_type` string: Set the post type `EVENT` or `OFFER`. By default the post type is standard. - `event_title` boolean: Set the event title. Required when topic_type is EVENT or OFFER - `event_start` string, date-time: Format should be Y-m-d H:i:s, Required when topic_type is EVENT or OFFER - `event_end` string, date-time: Format should be Y-m-d H:i:s, Required when topic_type is EVENT or OFFER - `offer_coupon` string: Coupon code for offer - `offer_link` string: Link where the offer can be redeemed - `offer_terms` string: Rules or conditions for redeeming the offer. - `call_to_action` string: a message that encourages users to take a specific action, could be `BOOK`, `ORDER`, `SHOP`, `LEARN_MORE`, `SIGN_UP`, or `CALL` - `call_to_action_url` string: Link to where you want the call-to-action button to take the user. - `save_media_to_gallery` boolean: Save the media in the gallery. - YoutubePostRequest - `accounts` integer[], required: ID(s) of one or more social media accounts. - `team_id` integer: Team Id of social media account. - `publish_at` string, required: Format should be Y-m-d H:i:s (UTC) - `content` string: The content for the post. - `draft` boolean: Save the post as a draft - `queue_ids` integer[]: If provided, the post will be added to the specified queues. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. - `postback_url` string: Receive postback at this URL if needed. Sends a JSON POST request with parameters `post_id`, `account_id`, and `status` (created, published, failed). - `tags` integer[]: ID(s) of existing tags to apply to the post (maximum 10). Use `GET /tags` to list available tags and `POST /tags` to create new ones. Not supported together with `queue_id`/`queue_ids` — a queued post has no tag scope until it's actually published, so sending `tags` alongside either is rejected. - `options` object: Additional options for the post. - `video_title` string: Title of video. - `video_tags` string: Add tags, separated by comma. - `category_id` integer: You can get the categories list from account's extra_data. - `privacy_status` string: Set the video privacy (public, private, or unlisted). - `post_as_short` boolean: Set true to post the video as youtube shorts. - `made_for_kids` boolean: Set true to post the video as made for kids. - `contains_synthetic_media` boolean: Disclose realistic altered or synthetic content, including Shorts. Maps to YouTube status.containsSyntheticMedia. Set true for Yes or false for No. - `thumbnail` object: Supported for posts having video attachment. - `name` string: File name (e.g., "image.png"). - `mimeType` string: MIME type of the media (e.g., "image/png"). - `extension` string: File type (e.g., "png") - `key` string: Media key, received when uploading media using media upload endpoint. - `url` string: Media URL, received when uploading media using media upload endpoint. - `secureKey` string: Media secure, key received when uploading media using media upload endpoint. - `temporary` boolean: Media status, received when uploading media using media upload endpoint. - `_metaData` object: Information about media. - `width` integer: Width of the media. - `height` integer: Height of the media. - TiktokPostRequest - `accounts` integer[], required: ID(s) of one or more social media accounts. - `team_id` integer: Team Id of social media account. - `publish_at` string, required: Format should be Y-m-d H:i:s (UTC) - `content` string: The content for the post. - `draft` boolean: Save the post as a draft - `queue_ids` integer[]: If provided, the post will be added to the specified queues. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. - `postback_url` string: Receive postback at this URL if needed. Sends a JSON POST request with parameters `post_id`, `account_id`, and `status` (created, published, failed). - `tags` integer[]: ID(s) of existing tags to apply to the post (maximum 10). Use `GET /tags` to list available tags and `POST /tags` to create new ones. Not supported together with `queue_id`/`queue_ids` — a queued post has no tag scope until it's actually published, so sending `tags` alongside either is rejected. - `options` object - `title` string: Title of Tiktok post. - `privacy_status` string, required: Set the post privacy to one of extra_data.creator_info.privacy_level_options (found in the Account object). For example, `PUBLIC_TO_EVERYONE`. - `allow_stitch` boolean: Set true to allow others to Stitch your video. - `allow_duet` boolean: Set true to allow others to create Duet videos with your post. - `allow_comment` boolean: Set true to allow comments on your post. - `disclose_content` boolean: Set true to indicate whether this content promotes yourself, a brand, product or service - `branded_content` boolean: Set true to indicate that you are in a paid partnership with a brand. - `own_brand` boolean: Set true to indicate that you are promoting yourself or your own business. - `auto_add_music` boolean: Set true to automatically add recommended music to directly published photo posts. Selecting a specific track is not supported by this API. - `is_aigc` boolean: Disclose AI-generated videos or photos separately from commercial content. Video inbox uploads require disclosure during final editing in TikTok. - `thumbnail` object: Add thumbnail to the video (video post only) - `name` string: File name (e.g., "image.png"). - `mimeType` string: MIME type of the media (e.g., "image/png"). - `extension` string: File type (e.g., "png") - `key` string: Media key, received when uploading media using media upload endpoint. - `url` string: Media URL, received when uploading media using media upload endpoint. - `secureKey` string: Media secure, key received when uploading media using media upload endpoint. - `temporary` boolean: Media status, received when uploading media using media upload endpoint. - `_metaData` object - `width` integer: Width of the media. - `height` integer: Height of the media. - BlueskyPostRequest - `accounts` integer[], required: ID(s) of one or more social media accounts. - `team_id` integer: Team Id of social media account. - `publish_at` string, required: Format should be Y-m-d H:i:s (UTC) - `content` string: The content for the post. - `draft` boolean: Save the post as a draft - `queue_ids` integer[]: If provided, the post will be added to the specified queues. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. - `postback_url` string: Receive postback at this URL if needed. Sends a JSON POST request with parameters `post_id`, `account_id`, and `status` (created, published, failed). - `tags` integer[]: ID(s) of existing tags to apply to the post (maximum 10). Use `GET /tags` to list available tags and `POST /tags` to create new ones. Not supported together with `queue_id`/`queue_ids` — a queued post has no tag scope until it's actually published, so sending `tags` alongside either is rejected. - `options` object: Additional options for the post. - `media_alt_text` string[]: Alternate text descriptions for each media item in the post. - `threaded_replies` object[]: Threaded replies (thread posts). Each reply can have text and/or media. - `text` string: The text content of the threaded reply. - `existing_attachments` UploadedMediaTokenAttachment[]: Attachments already uploaded to SocialBu's storage using media upload endpoint. - `upload_token` string, required: The value received from `/upload_media/status` or `/upload_media_by_url`. ## Response `200` Post created or saved to queue. - union - object - `success` boolean: Indicates whether the post was created successfully. - `posts` object[]: An array of created post objects. - object - `message` string ## Other responses - `400`: Bad Request - `422`: The given data was invalid. --- [API](https://skmtc.dev/socialbu/apis/socialbu-api.md) · [All operations](https://skmtc.dev/socialbu/apis/socialbu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/socialbu/apis/socialbu-api/revisions/841b3ab0f671?raw)