Create a Post

The core of the Viral Vibes API. Use this endpoint to publish or schedule content across multiple social platforms simultaneously.

Endpoint

POST/api/v1/post

Headers

HeaderValue
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Request Body

{
  "post": "Here is an awesome post! 🚀",
  "platforms": ["x", "linkedin", "facebook"],
  "mediaUrls": [
    "https://example.com/image1.jpg"
  ],
  "scheduleDate": "2026-03-25T14:30:00Z",
  "requireApproval": false
}

Parameters

  • post (string, required): The text content of your post. Max 2200 characters.
  • platforms (array, required): An array of strings indicating where to publish. Valid options: "x", "linkedin", "facebook", "instagram".
  • mediaUrls (array, optional): Publicly accessible URLs to images or videos you want to attach.
  • scheduleDate (string, optional): An ISO 8601 datetime string. If provided, the post is scheduled for the future instead of published immediately.
  • requireApproval (boolean, optional): If true, the post will be saved in an `awaiting_approval` state and will not be published until manually approved in the dashboard.

Response

A successful request returns a 202 Accepted status.

{
  "status": "success",
  "message": "Post accepted and saved to database",
  "data": {
    "id": "cuid123456789",
    "platforms": ["x", "linkedin"],
    "status": "processing",
    "createdAt": "2026-03-12T12:00:00.000Z"
  }
}