Create Text Post
Overview
The Create Text Post endpoint allows you to schedule and publish text-based posts to one or multiple connected social accounts under a specific category. You can set the post content, assign it to a category, and define the date and time for scheduling.
Base URL:
https://www.oneupapp.io
Endpoint
POST /api/scheduletextpost?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
Example:
POST https://www.oneupapp.io/api/scheduletextpost?apiKey=621544d93ffe2db52b01&category_id=49839&social_network_id=["pin_kumarvishi","accounts/116185162672310389659/locations/1366069594757511498"]&scheduled_date_time=2025-10-23 14:00&title=Hello+World+Title&content=Hello World! This is a scheduled post.
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. |
Sample Request
curl -X POST "https://www.oneupapp.io/api/scheduletextpost?apiKey=YOUR_API_KEY&category_id=49839&social_network_id=[\"pin_kumarvishi\",\"accounts/116185162672310389659/locations/1366069594757511498\"]&scheduled_date_time=2025-10-23 14:00&content=Hello World! This is a scheduled post."
Sample Response
{
"message": "1 new Posts Scheduled.",
"error": false,
"data": []
}
✅ Result: Your post has been successfully scheduled! The message confirms that the post is queued for publishing at the specified date and time.
Platform Support & Limitations
| Network | Character Limit | Notes |
|---|---|---|
| 10,000 | Full text supported with formatting | |
| X(Twitter) | 280 | 25,000 for premium accounts |
| 3,000 | Supports formatting like bold, italic | |
| 2,200 | For feed post captions | |
| Google Business | 1,500 | For business updates |
| 500 | For pin descriptions | |
| Threads | 500 | Maximum length |
| Bluesky | 300 | Maximum length |
Tips & Notes
- Make sure your target social accounts are active and not expired before scheduling.
- The
social_network_idmust exactly match the account IDs retrieved from the List Category Accounts or List Social Accounts endpoints. - For immediate publishing, you can set the
scheduled_date_timeto the current timestamp. - 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 posting workflow end-to-end.