API Reference

Errors

ShareViral returns JSON error bodies with a success flag and a human-readable message. Publishing endpoints may also succeed overall while individual platforms fail.

Status codes

200 — Request handled. For Make Post, check per-platform results.
400 — Validation error (missing fields, invalid schedule time, no matching accounts, missing media).
401 — Missing/invalid Bearer token or user not resolved.
403 — Plan restriction (Developer API or video publishing not allowed on the current plan).
404 — Resource not found (for example a scheduled post id that does not belong to you).
500 — Unexpected server error.

Error shape

Typical error response:

Error

{
  "success": false,
  "message": "Post text is required"
}

Partial success

Make Post can return success: true with a non-zero failed count. Always inspect the results array before treating a publish as fully successful.