OnlySocial
  1. Posts
OnlySocial
  • 🐶 OnlySocial API Walk through
  • Only Social
    • Accounts
      • List Accounts
      • Get an account
    • Media
      • List media files
      • Get a media file
      • Upload a media file
      • Delete a media file
      • Update a Media
    • Tags
      • List Tags
      • Get a tag
      • Create a tag
      • Delete a tag
      • Update a tag
    • Posts
      • List posts
        GET
      • Get a post
        GET
      • Create a post
        POST
      • Delete a post
        DELETE
      • Delete multiple post
        DELETE
      • Schedule a post
        POST
      • Add a post to Queue
        POST
      • Update a post
        PUT
      • Approve a Post
        POST
    • Groups
      • Create a group
      • Update a group
      • Delete a Group
  1. Posts

Create a post

POST
https://app.onlysocial.io/os/api/{workspaceUuid}/posts

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Body Params application/json

Example
{
  "accounts": [],
  "versions": [
    {
      "account_id": 0,
      "is_original": true,
      "content": [
        {
          "body": "",
          "media": [],
          "url": ""
        }
      ],
      "options": {
        "instagram": {
          "type": "reel",
          "collaborators": []
        },
        "instagram_direct": {
          "type": "reel",
          "collaborators": []
        },
        "mastodon": {
          "sensitive": false
        },
        "blue_sky": {
          "tags": []
        },
        "facebook_page": {
          "type": "post"
        },
        "threads": {
          "is_carousel": false
        },
        "youtube": {
          "title": "",
          "status": "public"
        },
        "google_m_b": {
          "image_post_type": 0,
          "video_post_type": 0,
          "text_post_type": 0,
          "all_post_type": 1,
          "topic_type": "none",
          "event_title": null,
          "start_date": null,
          "start_time": null,
          "end_date": null,
          "end_time": null,
          "selected_button_type": "NONE",
          "redirect_url": null,
          "couponCode": null,
          "redeemOnlineUrl": null,
          "termsConditions": null,
          "selected_media_category": "CATEGORY_UNSPECIFIED",
          "gmb_post": null
        },
        "reddit": {
          "title": null,
          "link": null,
          "subreddits": [],
          "flairs_status": null,
          "post_to_profile": true
        },
        "pinterest": {
          "title": "",
          "link": "",
          "boards": {
            "account-0": null
          }
        },
        "linkedin": {
          "visibility": "PUBLIC",
          "document": null,
          "document_title": null
        },
        "linkedin_page": {
          "visibility": "PUBLIC",
          "document": null,
          "document_title": null
        },
        "tiktok": {
          "privacy_level": {
            "account-0": ""
          },
          "allow_comments": {
            "account-0": false
          },
          "allow_duet": {
            "account-0": false
          },
          "allow_stitch": {
            "account-0": false
          },
          "content_disclosure": {
            "account-0": false
          },
          "brand_organic_toggle": {
            "account-0": false
          },
          "brand_content_toggle": {
            "account-0": false
          }
        },
        "tumblr": {
          "tumblr_image_post_type": 0,
          "tumblr_video_post_type": 0,
          "tumblr_text_post_type": 1,
          "tumblr_link_post_type": 0,
          "tumblr_quote_post_type": 0,
          "tumblr_chat_post_type": 0,
          "tumblr_post_type": "text",
          "tumblr_post_title": "",
          "tumblr_post_chat_title": "",
          "tumblr_post_link": "",
          "tumblr_post": null
        }
      }
    }
  ],
  "tags": [],
  "date": null,
  "time": "",
  "until_date": null,
  "until_time": "",
  "repeat_frequency": null,
  "short_link_provider": null,
  "short_link_provider_id": null
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://app.onlysocial.io/os/api/<workspaceUuid>/posts' \
--header 'Content-Type: application/json' \
--data-raw '{
  "accounts": [],
  "versions": [
    {
      "account_id": 0,
      "is_original": true,
      "content": [
        {
          "body": "",
          "media": [],
          "url": ""
        }
      ],
      "options": {
        "instagram": {
          "type": "reel",
          "collaborators": []
        },
        "instagram_direct": {
          "type": "reel",
          "collaborators": []
        },
        "mastodon": {
          "sensitive": false
        },
        "blue_sky": {
          "tags": []
        },
        "facebook_page": {
          "type": "post"
        },
        "threads": {
          "is_carousel": false
        },
        "youtube": {
          "title": "",
          "status": "public"
        },
        "google_m_b": {
          "image_post_type": 0,
          "video_post_type": 0,
          "text_post_type": 0,
          "all_post_type": 1,
          "topic_type": "none",
          "event_title": null,
          "start_date": null,
          "start_time": null,
          "end_date": null,
          "end_time": null,
          "selected_button_type": "NONE",
          "redirect_url": null,
          "couponCode": null,
          "redeemOnlineUrl": null,
          "termsConditions": null,
          "selected_media_category": "CATEGORY_UNSPECIFIED",
          "gmb_post": null
        },
        "reddit": {
          "title": null,
          "link": null,
          "subreddits": [],
          "flairs_status": null,
          "post_to_profile": true
        },
        "pinterest": {
          "title": "",
          "link": "",
          "boards": {
            "account-0": null
          }
        },
        "linkedin": {
          "visibility": "PUBLIC",
          "document": null,
          "document_title": null
        },
        "linkedin_page": {
          "visibility": "PUBLIC",
          "document": null,
          "document_title": null
        },
        "tiktok": {
          "privacy_level": {
            "account-0": ""
          },
          "allow_comments": {
            "account-0": false
          },
          "allow_duet": {
            "account-0": false
          },
          "allow_stitch": {
            "account-0": false
          },
          "content_disclosure": {
            "account-0": false
          },
          "brand_organic_toggle": {
            "account-0": false
          },
          "brand_content_toggle": {
            "account-0": false
          }
        },
        "tumblr": {
          "tumblr_image_post_type": 0,
          "tumblr_video_post_type": 0,
          "tumblr_text_post_type": 1,
          "tumblr_link_post_type": 0,
          "tumblr_quote_post_type": 0,
          "tumblr_chat_post_type": 0,
          "tumblr_post_type": "text",
          "tumblr_post_title": "",
          "tumblr_post_chat_title": "",
          "tumblr_post_link": "",
          "tumblr_post": null
        }
      }
    }
  ],
  "tags": [],
  "date": null,
  "time": "",
  "until_date": null,
  "until_time": "",
  "repeat_frequency": null,
  "short_link_provider": null,
  "short_link_provider_id": null
}'

Responses

🟢200Success
application/json
Body

Example
{
    "id": 3,
    "uuid": "6059e1b3-e102-4be5-951b-82698abd9ee3",
    "name": "Motivation",
    "hex_color": "#000000"
}
🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
🟠422Parameter Error
Modified at 2025-07-08 08:23:15
Previous
Get a post
Next
Delete a post
Built with