API Reference

Make Post

Publish a text, image, or video post to one or more connected social accounts in a single request.

POST/make-post

Requires a Developer API Bearer token. Connect the target platforms in ShareViral before calling this endpoint. See Authentication.

Request body

Send multipart/form-data. Full URL: https://shareviral-server-production.up.railway.app/api/v1/developer/make-post

Parameter	Type	Description
`postText`required	string	Caption / post body published to each selected platform.
`postType`required	'text' \| 'image' \| 'video'	Content kind. image and video require files (or staged media). Video requires Viral Pro or Business.
`accounts`required	string (CSV)	Comma-separated platform names to publish to, e.g. facebook,linkedin,tiktok. Matched against your connected accounts.
`files`optional	File[] (≤ 10)	Media uploads for image or video posts. Field name must be files.
`metadata`optional	string (JSON) \| object	Optional JSON metadata. ShareViral attaches your userId automatically when authenticated.

Platforms

The accounts field is a CSV of platform keys (lowercase). ShareViral resolves them against the social accounts connected to your user. Common values include facebook, instagram, linkedin, tiktok, threads, and x.

If no connected account matches a requested platform, that platform is skipped. If none match, the API returns 400 with “No accounts found”.

Examples

Text-only publish with cURL:

cURL

curl -X POST https://shareviral-server-production.up.railway.app/api/v1/developer/make-post \
  -H "Authorization: Bearer sv_your_api_token" \
  -F "postText=Launch week is live — join the waitlist." \
  -F "postType=text" \
  -F "accounts=facebook,linkedin,tiktok"

Same request in Node.js:

Node.js

const form = new FormData()
form.append('postText', 'Launch week is live — join the waitlist.')
form.append('postType', 'text')
form.append('accounts', 'facebook,linkedin,tiktok')

const response = await fetch(
  'https://shareviral-server-production.up.railway.app/api/v1/developer/make-post',
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer sv_your_api_token',
    },
    body: form,
  }
)

const data = await response.json()
console.log(data)

Response

On success the API returns aggregate counts plus a per-account results array. A top-level success can still include failed platforms—always inspect results.

200 OK

{
  "success": true,
  "total": 3,
  "successful": 2,
  "failed": 1,
  "results": [
    {
      "success": true,
      "platform": "facebook",
      "accountId": "…",
      "accountName": "My Page"
    },
    {
      "success": false,
      "platform": "tiktok",
      "accountId": "…",
      "error": "…"
    }
  ]
}

Errors

Post text is required /Post type is required
No accounts found — CSV did not match any connected account
Video posts require Viral Pro or Viral Business…