Misar.io Documentation

Connect a social account and schedule your first post with MisarSocial in under 5 minutes.

Schedule your first post

Log in to social.misar.io and navigate to Settings → Connected Accounts. Click Connect next to the platform you want to use.

Supported platforms: Twitter/X · LinkedIn · Instagram · Threads · TikTok · Bluesky

Each platform goes through its OAuth flow and returns an id you will use when scheduling posts.

Get your connected account ID

After connecting, retrieve your account IDs:

curl https://api.misar.io/social/api/connections \
  -H "Cookie: <your_session_cookie>"

Response:

{
  "accounts": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "platform": "twitter",
      "display_name": "@yourhandle",
      "avatar_url": "https://...",
      "status": "active"
    }
  ]
}

Generate post content (optional)

Use the AI generation endpoint to create platform-optimized variants:

curl -X POST https://api.misar.io/social/api/generate \
  -H "Content-Type: application/json" \
  -H "Cookie: <your_session_cookie>" \
  -d '{
    "topic": "We just launched our new API v2 with 3x faster response times",
    "platforms": ["twitter", "linkedin"],
    "tone": "professional",
    "count": 3
  }'

Response includes up to 3 variants per platform, each with a caption and hashtags array.

Schedule a post

Use the connected account ID from Step 2 to schedule your post:

curl -X POST https://api.misar.io/social/api/schedule \
  -H "Content-Type: application/json" \
  -H "Cookie: <your_session_cookie>" \
  -d '{
    "connectedAccountId": "550e8400-e29b-41d4-a716-446655440000",
    "platform": "twitter",
    "contentText": "We just launched our new API v2 with 3x faster response times! #API #Engineering",
    "scheduledAt": "2026-05-22T10:00:00+05:30"
  }'

A 201 response means the post is queued. The status field in the response will be "queued".

Monitor your posts

Check the status of all your scheduled posts:

curl "https://api.misar.io/social/api/posts?status=queued" \
  -H "Cookie: <your_session_cookie>"

Using the TypeScript SDK

For server-side integrations, use the SDK instead of raw fetch:

import { MisarSocialClient } from "@misar/social-sdk";

const client = new MisarSocialClient({
  apiKey: process.env.MISARSOCIAL_API_KEY!,
});

// Generate variants
const { variants } = await client.generate({
  topic: "Our new product launch",
  platforms: ["twitter", "linkedin"],
  tone: "professional",
  count: 3,
});

// Schedule the first Twitter variant
await client.schedule({
  connectedAccountId: "550e8400-...",
  platform: "twitter",
  contentText: variants[0].variants[0].caption,
  scheduledAt: "2026-05-22T10:00:00Z",
});

See the TypeScript SDK guide for full reference.

Quickstart