logo
Schedulin Developers

Create a scheduled post

Set action: "schedule" and an ISO 8601 scheduledAt timestamp. Each media item needs a url.

curl -X POST https://api.schedulin.app/v0/posts \
  -H "x-api-key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "socialAccountId": "acc_123",
    "caption": "Weekend sale starts now ☀️",
    "media": [{ "url": "https://cdn.example.com/sale.jpg" }],
    "action": "schedule",
    "scheduledAt": "2026-06-07T09:00:00Z"
  }'
import { SchedulinClient } from "@schedulin/sdk";

const client = new SchedulinClient({ apiKey: process.env.SCHEDULIN_API_KEY });

await client.posts.create({
  socialAccountId: "acc_123",
  caption: "Weekend sale starts now ☀️",
  media: [{ url: "https://cdn.example.com/sale.jpg" }],
  action: "schedule",
  scheduledAt: "2026-06-07T09:00:00Z",
});
from schedulin import Schedulin

client = Schedulin(api_key=os.environ["SCHEDULIN_API_KEY"])

client.posts.create(
    social_account_id="acc_123",
    caption="Weekend sale starts now ☀️",
    media=[{"url": "https://cdn.example.com/sale.jpg"}],
    action="schedule",
    scheduled_at="2026-06-07T09:00:00Z",
)
TIP
To add the post to the channel's posting queue instead of a fixed time, use and omit .