postqued-api_skill

Overview

This skill integrates PostQued's social media scheduling API for uploading content, managing platform accounts, and publishing or scheduling posts (including TikTok drafts). It handles presigned video uploads, direct image uploads, publish requests with idempotency, and query operations for publish status. Use it to automate content pipelines and coordinate multi-platform dispatches reliably.

How this skill works

The skill authenticates with a PostQued API key and calls the REST endpoints at https://api.postqued.com. It uploads media (presigned PUT for videos, multipart for images), retrieves platform account IDs, and creates publish requests that include idempotency keys and target platform options. It also polls or queries publish status and handles common API error responses and rate limits.

When to use it

• Automating uploads and scheduling for TikTok and other supported platforms
• Sending video files via presigned URL uploads or images via direct upload
• Creating draft posts to a TikTok inbox or scheduling future dispatches
• Querying publish status or retrying failed/partial publishes
• Managing linked platform accounts and fetching account metadata

Best practices

• Store the POSTQUED_API_KEY securely in environment variables and use Bearer auth headers
• Always include a unique Idempotency-Key per publish request (valid 24 hours) to prevent duplicate publishes
• Respect rate limits: separate upload/read/publish workflows and add exponential backoff on 429 responses
• Validate media metadata (size, duration, dimensions) before confirming uploads
• Use dispatchAt as UTC ISO timestamps for scheduling and set null for immediate dispatch

Example use cases

• Batch upload videos to PostQued, then schedule them to multiple TikTok accounts with platform-specific options
• Upload an image and publish immediately to a linked account with privacy and comment settings adjusted
• Create a publish request with intent=draft so content lands in a user’s TikTok drafts for manual review
• Poll publish status after submission to detect 'partial_failed' or 'failed' targets and trigger retries or alerts
• Fetch platform-accounts?platform=tiktok to list connected accounts and present choices in a UI