/social-media/create

post

https://api.simplified.com/api/v1/service/social-media/create

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

Create

Create and schedule a social media post/draft across one or more connected accounts, with optional media, auto-comments, and platform-specific configurations.

💬 `comments` Parameter Reference

Pass a comments array to publish one or more auto-comments to the post after it goes live. Each entry is published in array order once the post is live.

"comments": [
  { "message": "Thanks for reading! 🙌", "delay": 0 },
  { "message": "Follow for more updates.", "delay": 120 },
  { "message": "Link in bio 👇", "delay": 300 }
]

Field	Type	Required	Default	Description
`message`	string	No	`""`	The comment text.
`delay`	integer (seconds)	No	`0`	Seconds to wait after the post is published before posting this comment.

Notes:

delay is cast to an integer, so "60" (string) and 60 are equivalent.
A comment with no message is still accepted; message defaults to an empty string.
Comments are processed in array order.
Omit comments (or send comments: []) for no auto-comments.

📦 `additional` Parameter Reference

The additional object allows platform-specific enhancements to your scheduled posts.

🟢 Google

"google": {
  "post": {
    "title": "title post",
    "topicType": "STANDARD",
    "couponCode": "coupon code",
    "callToActionUrl": "call to action url",
    "redeemOnlineUrl": "redeem online url",
    "termsConditions": "terms conditions",
    "callToActionType": "SIGN_UP"
  }
}

Field	Type	Description
`title`	string	Title of the post
`topicType`	string	Post topic type (e.g., `STANDARD`)
`couponCode`	string	Coupon code for promotions
`callToActionUrl`	string	URL for CTA button
`redeemOnlineUrl`	string	URL to redeem offers online
`termsConditions`	string	Terms and conditions text
`callToActionType`	string	CTA type (`SIGN_UP`, `LEARN_MORE`, etc.)

🎵 TikTok / TikTok Business

"tiktok": {
  "post": {
    "brandContent": true,
    "brandOrganic": true,
    "duetDisabled": true,
    "privacyStatus": "PUBLIC_TO_EVERYONE",
    "stitchDisabled": true,
    "commentDisabled": true
  },
  "channel": {
    "value": "direct"
  },
  "postType": {
    "value": "video"
  },
  "postPhoto": {
    "title": "Video title",
    "brandContent": true,
    "brandOrganic": true,
    "duetDisabled": true,
    "privacyStatus": "PUBLIC_TO_EVERYONE",
    "stitchDisabled": true,
    "commentDisabled": true
  }
}

Field	Type	Description
`brandContent`	boolean	Marks as branded content
`brandOrganic`	boolean	Marks as organic brand content
`duetDisabled`	boolean	Disables duet feature
`privacyStatus`	string	Visibility (`PUBLIC_TO_EVERYONE`, etc.)
`stitchDisabled`	boolean	Disables stitch
`commentDisabled`	boolean	Disables comments
`channel.value`	string	Channel type (e.g., `direct`)
`postType.value`	string	Type of content (`video`, `photo`, etc.)
`postPhoto.title`	string	Title of the TikTok video for image-based posts

🧵 Threads

"threads": {
  "channel": {
    "value": "direct"
  }
}

Field	Type	Description
`channel.value`	string	Posting method (`direct`)

📺 YouTube

"youtube": {
  "post": {
    "title": "YT title video",
    "license": "creativeCommon",
    "privacyStatus": "public",
    "selfDeclaredMadeForKids": "yes"
  },
  "postType": {
    "value": "short"
  }
}

Field	Type	Description
`title`	string	Video title
`license`	string	`standard` or `creativeCommon`
`privacyStatus`	string	`public`, `private`, or `unlisted`
`selfDeclaredMadeForKids`	string	`yes` or `no`
`postType.value`	string	Video type (`short`, `video`)

📘 Facebook

"facebook": {
  "postType": {
    "value": "story"
  }
}

Field	Type	Description
`postType.value`	string	`story`, `feed`, etc.

💼 LinkedIn

"linkedin": {
  "audience": {
    "value": "PUBLIC"
  }
}

Field	Type	Description
`audience.value`	string	`PUBLIC`, `CONNECTIONS`, etc.

📸 Instagram

"instagram": {
  "postReel": {
    "audioName": "Audio name",
    "shareToFeed": true
  },
  "postType": {
    "value": "post"
  }
}

Field	Type	Description
`audioName`	string	Custom audio track for reel
`shareToFeed`	boolean	Also share reel to the Instagram feed
`postType.value`	string	Post type (`post`, `reel`, etc.)

📌 Pinterest

"pinterest": {
  "post": {
    "link": "link",
    "title": "title",
    "imageAlt": "image alt"
  }
}

Field	Type	Description
`link`	string	Destination URL
`title`	string	Pin title
`imageAlt`	string	Alt text for the pin image

OpenAPI definition

{
  "openapi": "3.0.2",
  "info": {
    "title": "Simplified AI Services",
    "version": "1.1.0",
    "description": "Simplified AI service tools"
  },
  "paths": {
    "/social-media/create": {
      "post": {
        "description": "",
        "operationId": "get_social-mediacreate",
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "examples": {
                  "New Example": {
                    "summary": "New Example",
                    "value": ""
                  },
                  "New Example 1": {
                    "summary": "New Example 1",
                    "value": {
                      "ids": [
                        "6310"
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "action": {
                    "type": "string",
                    "description": "Action type, e.g. schedule, add_to_queue, draft"
                  },
                  "account_ids": {
                    "type": "array",
                    "description": "Array of account IDs to publish to",
                    "items": {
                      "type": "integer"
                    }
                  },
                  "message": {
                    "type": "string",
                    "description": "The text content of the post"
                  },
                  "date": {
                    "type": "string",
                    "description": "Scheduled date and time in format YYYY-MM-DD HH:MM (24h)"
                  },
                  "media": {
                    "type": "array",
                    "description": "Array of media URLs or Asset Ids (images, videos, etc.)",
                    "items": {
                      "type": "string"
                    }
                  },
                  "comments": {
                    "type": "array",
                    "description": "Auto-comments published to the post after it goes live. Processed in array order.",
                    "items": {
                      "type": "object",
                      "properties": {
                        "message": {
                          "type": "string",
                          "description": "The comment text."
                        },
                        "delay": {
                          "type": "integer",
                          "description": "Seconds to wait after the post is published before posting this comment."
                        }
                      }
                    }
                  },
                  "additional": {
                    "type": "object",
                    "description": "Platform-specific options (e.g., TikTok settings)",
                    "properties": {
                      "google": {
                        "type": "object",
                        "properties": {}
                      },
                      "tiktok": {
                        "type": "object",
                        "properties": {}
                      },
                      "threads": {
                        "type": "object",
                        "properties": {}
                      },
                      "youtube": {
                        "type": "object",
                        "properties": {}
                      },
                      "facebook": {
                        "type": "object",
                        "properties": {}
                      },
                      "linkedin": {
                        "type": "object",
                        "properties": {}
                      },
                      "instagram": {
                        "type": "object",
                        "properties": {}
                      },
                      "pinterest": {
                        "type": "object",
                        "properties": {}
                      },
                      "tiktokBusiness": {
                        "type": "object",
                        "properties": {}
                      }
                    }
                  }
                },
                "type": "object",
                "required": [
                  "action",
                  "account_ids"
                ]
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "Api-Key": {
        "type": "apiKey",
        "description": "Prefix the value with \"Api-Key\" like Api-Key <api-token>",
        "name": "Authorization",
        "in": "header"
      }
    }
  },
  "servers": [
    {
      "url": "https://api.simplified.com/api/v1/service",
      "description": "Production server"
    }
  ],
  "security": [
    {
      "Api-Key": []
    }
  ],
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json