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

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 ~~.
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 image post types:

Instagram:

• instagram: A JSON object with the following option:
  • isStory (boolean): Set to true to publish as an Instagram Story. Default: false

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

TikTok:

• tiktok: A JSON object with the following option:
  • autoAddMusic (boolean): Set to true to automatically add music to the image post. Default: true

Example with platform-specific parameters:

curl --location --request POST \
"https://www.oneupapp.io/api/scheduleimagepost" \
--data-urlencode "apiKey=621544d93ffe2db52b01" \
--data-urlencode "category_id=49839" \
--data-urlencode 'social_network_id=["113024478527731"]' \
--data-urlencode "scheduled_date_time=2026-12-12 13:13" \
--data-urlencode "title=My Image Post" \
--data-urlencode "content=Image post" \
--data-urlencode "image_url=https://cdn.filestackcontent.com/BT933lwUSEKkmpfI9O57" \
--data-urlencode 'instagram={"isStory":true}'

Sample Response

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

✅ Result: Your image post (with one or multiple images) has been successfully scheduled! The message confirms that the post is queued for publishing at the specified date and time.

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.
• 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 image posting workflow end-to-end.