API documentation

Postena exposes a small HTTP API so you can publish or schedule videos from your own scripts and workflows. Every request is authenticated.

Authentication

Programmatic requests must include your secret key in the X-API-Key header. Requests without a valid key (or an active dashboard session) are rejected with 401. You can find your key in your Postena configuration; keep it private.

X-API-Key: your_api_key_here

Publish a video now

Publishes a video to your connected TikTok account immediately.

curl -X POST https://your-domain/api/publish \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "videoPath": "/videos/clip.mp4",
    "caption": "New drop #video",
    "coverMs": 1000
  }'

→ { "ok": true, "publish_id": "v2.123..." }

Schedule a video

Same fields as publish, plus an at timestamp. Postena stores the video and publishes it automatically at that time.

curl -X POST https://your-domain/api/schedule \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "videoPath": "/videos/clip.mp4", "caption": "Tomorrow", "coverMs": 800, "at": "2026-09-01T18:00:00Z" }'

→ { "ok": true, "id": "6304...", "at": "2026-09-01T18:00:00.000Z" }

Check publish status

curl "https://your-domain/api/publish/status?publish_id=v2.123..."
→ { "status": "PUBLISH_COMPLETE" }