PostFlow Developer Documentation

PostFlow by Wentix AI is a single unified API and automation engine that empowers developers and AI agents to connect, publish, schedule, moderate, and analyze content seamlessly across 15 social platforms.

⚡ Quickstart: Send Your First Multi-Platform Post

Publish a video reel to TikTok, Instagram, and YouTube Shorts simultaneously in a single API call:

curl -X POST https://publishred.wentixai.pro/api/v1/posts \
  -H "Authorization: Bearer wtk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Accelerate your AI workflows with PostFlow by Wentix AI! 🚀 #ai #automation #growth",
    "mediaUrls": ["https://cdn.wentixai.pro/assets/videos/demo-reel.mp4"],
    "platforms": ["tiktok", "instagram", "youtube"],
    "platformOptions": {
      "youtube": {
        "title": "Automate Social Media with Wentix AI",
        "privacyStatus": "public",
        "madeForKids": false
      },
      "instagram": {
        "mediaType": "REELS",
        "shareToFeed": true
      },
      "tiktok": {
        "disableComment": false,
        "disableDuet": false
      }
    },
    "scheduledAt": "2026-09-30T15:00:00Z"
  }'

import { PostFlowClient } from '@wentix/postflow-sdk';

const client = new PostFlowClient({
  apiKey: process.env.POSTFLOW_API_KEY
});

const post = await client.posts.create({
  caption: 'Accelerate your AI workflows with PostFlow by Wentix AI! 🚀 #ai #automation #growth',
  mediaUrls: ['https://cdn.wentixai.pro/assets/videos/demo-reel.mp4'],
  platforms: ['tiktok', 'instagram', 'youtube'],
  platformOptions: {
    youtube: {
      title: 'Automate Social Media with Wentix AI',
      privacyStatus: 'public'
    },
    instagram: { mediaType: 'REELS' }
  },
  scheduledAt: new Date('2026-09-30T15:00:00Z')
});

console.log('Created Post ID:', post.id, post.status);

import os
from postflow import PostFlow

client = PostFlow(api_key=os.environ.get("POSTFLOW_API_KEY"))

response = client.posts.create(
    caption="Accelerate your AI workflows with PostFlow by Wentix AI! 🚀 #ai #automation #growth",
    media_urls=["https://cdn.wentixai.pro/assets/videos/demo-reel.mp4"],
    platforms=["tiktok", "instagram", "youtube"],
    platform_options={
        "youtube": {"title": "Automate Social Media with Wentix AI", "privacyStatus": "public"},
        "instagram": {"mediaType": "REELS"}
    },
    scheduled_at="2026-09-30T15:00:00Z"
)

print(f"Scheduled post: {response.id} -> Status: {response.status}")

🔐 Authentication & API Keys

PostFlow uses secure Bearer tokens to authenticate all requests. API keys can be generated in your Dashboard > Settings > API Keys.

Include your token in the standard HTTP Authorization header:

Authorization: Bearer wtk_live_9f83a2e18bc0094d27a...

📦 POST /api/v1/posts

Publish immediately or schedule a post across one or more connected social accounts.

Request Body Parameters

Response 200 OK

{
  "success": true,
  "data": {
    "id": "pst_893240a1bf",
    "status": "SCHEDULED",
    "scheduledAt": "2026-09-30T18:00:00Z",
    "caption": "Accelerate your AI workflows with PostFlow by Wentix AI! 🚀",
    "platforms": ["tiktok", "instagram", "youtube"],
    "platformResults": {
      "tiktok": { "status": "QUEUED" },
      "instagram": { "status": "QUEUED" },
      "youtube": { "status": "QUEUED" }
    },
    "createdAt": "2026-09-27T18:00:00Z"
  }
}

🤖 Model Context Protocol (MCP) Server

PostFlow includes an official Model Context Protocol (MCP) server. This allows AI assistants like Claude Desktop, Cursor IDE, Windsurf, and Autonomous LLM Agents to natively inspect your connected accounts, publish posts, schedule campaigns, and query social analytics.

Claude Desktop & Cursor Configuration

{
  "mcpServers": {
    "postflow": {
      "command": "npx",
      "args": ["-y", "@wentix/postflow-mcp-server"],
      "env": {
        "POSTFLOW_API_KEY": "wtk_live_YOUR_API_KEY"
      }
    }
  }
}

Available MCP Tools

• postflow_list_accounts: Returns all connected social profiles, health status, and follower counts.
• postflow_publish_post: Creates and schedules posts with automatic media validation and multi-network formatting.
• postflow_get_post_analytics: Queries real-time views, likes, shares, comments, and engagement rates.
• postflow_moderate_comments: Lists and replies to comments across Facebook, Instagram, TikTok, and YouTube.

📊 Bulk CSV Scheduling Engine

You can schedule hundreds of posts across all 15 platforms in one click by uploading a formatted CSV spreadsheet.

📸 Instagram Platform Guide

Supports Instagram Professional (Business & Creator) accounts for Publishing Reels, Photo Carousels, Stories, and Single Images.

• Reels: 9:16 aspect ratio (1080x1920), up to 90 seconds, MP4/MOV container.
• Carousels: Up to 10 images or videos in 1:1, 4:5, or 16:9 aspect ratios.
• Collaborator Tags: Invite co-authors with collaboratorUsernames: ["@wentixai"].
• Audio & Music: Add custom audio or trigger Instagram Audio ID integration.

🎵 TikTok Platform Guide

Publish short-form videos and multi-photo slideshows directly to TikTok personal and business profiles.

• Commercial Music Library (CML): Automatic licensing checks for commercial business accounts.
• Photo Mode: Multi-image carousel posts with background sound tracks.
• Privacy & Permissions: Toggle disableComment, disableDuet, and disableStitch per post.

▶️ YouTube (Shorts & Standard Video)

Upload videos of any duration, automatically tag YouTube Shorts, and organize content into playlists.

• Shorts Detection: Vertical videos under 60 seconds are automatically designated as Shorts.
• Metadata: Custom video title (up to 100 chars), description (5,000 chars), tags, category ID, and custom thumbnail upload.

💼 LinkedIn (Profiles & Company Pages)

Publish rich-media updates, multi-page PDF documents/carousels, and long-form articles to LinkedIn Personal Profiles and Organization Pages.

🐦 X / Twitter (Tweets, Threads & Media)

Post standalone tweets, automated multi-tweet threads, polls, and media attachments with support for X Premium long-form character limits.

💬 Discord & Slack Channel Bots

Dispatch rich embeds, notifications, and media drops directly to Discord text channels and Slack workspaces via incoming webhooks or bot tokens.

📍 Google Business Profile (GBP)

Publish local business updates, event announcements, special offers with call-to-action buttons (Call, Order, Learn More), and photos across multiple physical locations.