API Reference
Create Scheduled Post
Queue a post on the ShareViral content calendar to publish at a future time.
POST/scheduled-posts
Authenticate with a Bearer
sv_ token. See Authentication.Request body
Send multipart/form-data. Full URL: https://shareviral-server-production.up.railway.app/api/v1/developer/scheduled-posts
| Parameter | Type | Description |
|---|---|---|
postTextrequired | string | Caption / post body for the scheduled publish. |
postTyperequired | 'text' | 'image' | 'video' | Content kind. image/video require files or mediaUrls. Video requires Pro/Business. |
accountsrequired | string (CSV) | Comma-separated platforms, e.g. facebook,linkedin. Resolved to your connected accounts. |
scheduledForrequired | string (ISO 8601) | When to publish. Also accepted as scheduledAt, scheduled_for, or scheduled_at. |
filesoptional | File[] (≤ 10) | Media uploads for image or video posts. |
mediaUrlsoptional | string[] (JSON) | Alternative to uploading files: public URLs for image media. |
metadataoptional | string (JSON) | object | Optional platform metadata object. |
Examples
cURL
curl -X POST https://shareviral-server-production.up.railway.app/api/v1/developer/scheduled-posts \
-H "Authorization: Bearer sv_your_api_token" \
-F "postText=Launch week is live — join the waitlist." \
-F "postType=text" \
-F "accounts=facebook,linkedin" \
-F "scheduledFor=2026-07-20T15:00:00.000Z"Response
Returns the new scheduled post id, used for update and delete.
200 OK
{
"success": true,
"id": "abc123…"
}