postproxy_skill

Overview

This skill calls the PostProxy API to create, manage, schedule, and publish social media posts across Facebook, Instagram, TikTok, LinkedIn, YouTube, X/Twitter, and Threads. It handles posting with remote media URLs or file uploads, supports drafts, scheduling, and platform-specific options like Instagram reels or YouTube titles. API access requires a POSTPROXY_API_KEY set as an environment variable.

How this skill works

The skill makes authenticated HTTP requests to https://api.postproxy.dev using a Bearer token from the POSTPROXY_API_KEY environment variable. It lists profiles and posts, creates posts via JSON or multipart form uploads, schedules posts with ISO timestamps, creates drafts, publishes drafts, and deletes posts. Platform-specific parameters are passed in a 'platforms' object to set format, privacy, and other native options.

When to use it

• Publish the same post to multiple social platforms simultaneously.
• Upload local images or video files and attach them to a post.
• Create drafts for review and publish them later or on a schedule.
• Schedule content in advance with precise ISO 8601 timestamps.
• Delete or fetch existing posts and list connected profiles.

Best practices

• Store your API key securely in POSTPROXY_API_KEY and never hard-code it.
• Use JSON payloads with media URLs for server-side hosted assets; use multipart form when uploading local files.
• Validate scheduled_at timestamps in UTC (ISO 8601) to avoid timezone errors.
• Test platform-specific options (format, privacy_status, titles) per network to meet content restrictions.
• Handle API errors and rate limits: retry with backoff and log responses for debugging.

Example use cases

• Cross-post a product announcement to Twitter, LinkedIn, and Instagram with one API call.
• Create a draft campaign with images for review, then publish all drafts at launch time.
• Upload a set of images via multipart form to create an Instagram carousel and schedule it for peak engagement.
• Publish a YouTube video with a custom title and public privacy status while posting a teaser to TikTok.