Create Video Post

Overview

The Create Video Post endpoint allows you to schedule and publish video-based posts to one or multiple connected social accounts under a specific category. You can set the post content, attach a video URL, assign it to a category, and define the date and time for scheduling.

Base URL:

https://www.oneupapp.io

Endpoint

POST /api/schedulevideopost

Request Parameters

Parameter	Required	Description
apiKey	Yes	Your personal API key generated from the API Access page.
category_id	Yes	The ID of the category that groups your target social accounts.
social_network_id	Yes	A JSON array of social network IDs where the post will be published. You can also set the value to ALL to publish the post across all accounts enabled for the selected category.
scheduled_date_time	Yes	The date and time (in YYYY-MM-DD HH:MM format) when the post should be published.
title	No	The title of your post.
content	Yes	The text content of your post.
video_url	Yes	The URL to the video you want to attach to the post.
thumbnail_url	No	The URL of the thumbnail image for video posts (optional and only for video posts).
first_comment	No	The first comment to be added to the post (optional and only for Facebook, Instagram, LinkedIn, and YouTube).

Platform-Specific Parameters

Some social networks support additional parameters for specific video post types:

Instagram:

• instagram: A JSON object with the following options:
  • isStory (boolean): Set to true to publish as an Instagram Story. Default: false
  • isTrialReel (optional):
    • 1 -> The trial reel can be manually graduated in the Instagram app.
    • 2 -> The trial reel will be automatically graduated if the trial reel performs well.

Facebook:

• facebook: A JSON object with the following option:
  • isStory (boolean): Set to true to publish as a Facebook Story. Default: false

Snapchat:

• snapchat: A JSON object with the following option:
  • isSpotLight (boolean): Set to true to publish as a Snapchat Spotlight. Default: false

Example with platform-specific parameters:

curl --location --request POST \
"https://www.oneupapp.io/api/schedulevideopost" \
--data-urlencode "apiKey=621544d93ffe2db52b01" \
--data-urlencode "category_id=49839" \
--data-urlencode 'social_network_id=["17841408823790514"]' \
--data-urlencode "scheduled_date_time=2026-12-12 13:13" \
--data-urlencode "title=My Video Post" \
--data-urlencode "content=Video post from API" \
--data-urlencode "video_url=https://cdn.filestackcontent.com/tpVlPE0qT7u4TwyPoA1M" \
--data-urlencode 'instagram={"isStory":true, "isTrialReel":1}'

Sample Response

{
  "message": "1 new Posts Scheduled.",
  "error": false,
  "data": []
}

✅ Result: Your video post has been successfully scheduled! The message confirms that the post is queued for publishing at the specified date and time.

Tips & Notes

• Ensure your target social accounts are active and not expired before scheduling.
• The social_network_id must exactly match the account IDs retrieved from the List Category Accounts or List Social Accounts endpoints.
• The video_url must be publicly accessible and point directly to a video file.
• For immediate publishing, set scheduled_date_time to the current timestamp.
• Avoid overloading with too many simultaneous posts to prevent API rate limiting.
• When using platform-specific parameters, ensure the JSON is properly formatted and URL-encoded in the request.

✅ Next Step: Combine this with your category and account lookups to automate the video posting workflow end-to-end.