Create Image Post

Overview

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

Base URL:

https://www.oneupapp.io

Endpoint

POST /api/scheduleimagepost?apiKey=YOUR_API_KEY&category_id=CATEGORY_ID&social_network_id=["NETWORK_ID_1","NETWORK_ID_2"]&scheduled_date_time=YYYY-MM-DD HH:MM&title=Your+Post+Title&content=Your post content here&image_url=IMAGE_URLS

Multiple Images:

To include multiple images in a single post, separate each image URL with ~~~.

Example:

POST https://www.oneupapp.io/api/scheduleimagepost?apiKey=621544d93ffe2db52b01&category_id=49839&social_network_id=["113024478527731"]&scheduled_date_time=2026-12-12 13:13&title=My+Image+Post&content=Image post&image_url=https://cdn.filestackcontent.com/BT933lwUSEKkmpfI9O57~~~https://cdn.filestackcontent.com/abc123~~~https://cdn.filestackcontent.com/xyz789

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.
image_url	Yes	The URL(s) of the image(s). Separate multiple images with ~~~.

Sample Response

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

✅ Result: Your image post (with one or multiple images) has been successfully scheduled!

Platform Photo Upload Limits

Platform	Max Photos	Photo Size Limit	Caption Support	Notes
Facebook	20	No restriction	Yes	Supports alt text, no restrictions on photo size.
Instagram	10	8 MB	Yes	Minimum resolution: 320×320 px, automatically cropped.
TikTok	35	No restriction	No	Cannot mix photos with GIFs or videos.
Threads	20	8 MB	No	Cannot mix photos with GIFs or videos.
X(Twitter)	4	5 MB	No	Supports only up to 4 photos per post.
LinkedIn	9	No restriction	No	Photos and GIFs are supported, cannot mix with videos.
Bluesky	4	1 MB	No	Supports up to 4 images per post, alt text available.

Tips & Notes

• Make sure your target social accounts are active and not expired before scheduling.
• The social_network_id must match the account IDs retrieved from the List Category Accounts or List Social Accounts endpoints.
• Ensure all image_urls are publicly accessible and point directly to image files.
• Use ~~~ to separate multiple images in the image_url parameter.
• Avoid overloading with too many simultaneous posts to prevent API rate limiting.

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