How-to guides

• How to Schedule LinkedIn Posts (and Find or Edit Them Later)

  LinkedIn's built-in scheduler works for one account at a time. Here's how it works, where scheduled posts hide, and how to schedule LinkedIn posts programmatically with Postproxy.

  LinkedIn's native scheduler accepts a publish time from 10 minutes to 3 months ahead for member posts, and from 1 hour to 3 months ahead for Page posts. Scheduled posts live behind the clock icon in the composer, where they can be rescheduled, edited, or deleted. Via API, a post is scheduled by adding an ISO 8601 `scheduled_at` timestamp.

• How to Schedule Instagram Stories via API

  Instagram has no native Story scheduling — the Graph API publishes immediately. Here's how to queue Stories and fire them at an exact time, with Node, Python and curl.

  Instagram has no native Story scheduling — the API publishes immediately, so a scheduler holds the media and fires at your chosen time. A Story lives 24 hours from that moment, takes no caption, and is single-media only.

• How to Auto-Post YouTube Shorts via API

  Auto-publish YouTube Shorts at scale with Postproxy. Title, privacy, tags, category, AI-disclosure, and how scheduling actually works.

  A Short is any video under 60 seconds in a vertical aspect ratio — YouTube classifies it automatically, there is no Shorts flag in the API. Publish it like any other upload and the format decides the placement.

• How to Auto-Publish Pinterest Pins via API

  Auto-pin every new blog post or piece of content to Pinterest. Real Postproxy params: board_id, destination_link, title, cover_url.

  Publishing a Pin needs exactly one Pinterest-specific parameter through Postproxy: board_id. Titles cap at 100 characters and destination links at 2,048, and the rest of the request looks the same as any other platform.

• How to Schedule & Auto-Post to Threads via API

  Schedule Threads posts and auto-publish them on a timer. Threads has no native scheduling — here's how to queue posts and publish automatically, with Node, Python and curl.

  Threads has no native scheduling — the API publishes the moment you call it, so a scheduler must hold the post and fire at the right second. Containers expire after 24 hours and video needs a processing wait before publish.

• How to Schedule Instagram Reels via API

  Instagram's Graph API doesn't accept future timestamps for Reels. Here's how to schedule Reels with Postproxy — container handling, processing waits, and exact-time publishing.

  Scheduled Reels need a system that holds the post, creates the container, polls until processing finishes, then publishes. Reels take MP4 or MOV at 9:16, 3 seconds to 90 minutes, up to 300 MB, captions to 2,200 characters — still images are rejected outright.

• How to Post to a LinkedIn Company Page via API

  Posting to a LinkedIn company page requires different OAuth scopes and a different author URN than personal posts. Here's the full pattern with Postproxy.

  Posting as a company page rather than a person needs different OAuth scopes and an organization author URN, and the authenticating user must hold ADMINISTRATOR or CONTENT_ADMIN on the page. Getting either wrong returns a permissions error, not a clear one.

• How to Schedule TikTok Posts via API

  TikTok's Content Posting API has no native scheduling. Here's how to schedule TikTok posts with Postproxy — exact-time and queue-based, with the real request shapes.

  TikTok's Content Posting API only posts immediately; its own scheduling supports private uploads with a future publishAt, which is not the same thing. Scheduled public posting means holding the video and calling the API at the right time.

• How to Cross-Post a Video to Every Social Platform via API

  One MP4 to TikTok, Instagram Reels, YouTube, X, LinkedIn, Threads, Facebook, Pinterest, and Bluesky in a single API call. Spec table and code included.

  One video, one API call, every platform — but the limits differ sharply: TikTok accepts up to 4 GB while Instagram and most others cap near 300 MB, and captions run to 2,200 characters on several. Publish once and let per-platform parameters handle what diverges.

• How to Publish an Instagram Carousel via API

  Instagram carousels need N child containers, one carousel container, and a publish call. Postproxy collapses it to one POST.

  Publish an Instagram carousel with one POST. Postproxy creates every child container, the parent container, and the publish call for you — no orphan containers, no pending-container ceiling to manage.

• How to Repurpose YouTube Videos to Shorts, Reels, and TikTok

  Turn one long-form YouTube video into vertical clips for Shorts, Reels, and TikTok. ffmpeg recipe + Postproxy publishing in one workflow.

  One long-form YouTube video becomes vertical clips with two ffmpeg operations: trim to under 60 seconds and crop to 9:16. The same clip then publishes to Shorts, Reels and TikTok in a single API call, with per-platform caption overrides where the formats differ.

• How to Schedule Social Media Posts from Google Sheets

  Turn one row in a Google Sheet into one scheduled post across every platform. A step-by-step guide to wiring Google Apps Script to the Postproxy API for bulk scheduling.

  A Google Apps Script trigger reads rows from a sheet and posts each through the Postproxy API on a schedule. Apps Script caps runs at roughly 15 minutes with a daily UrlFetch quota, so batch sizes and a processed-row marker matter more than the API call itself.

• How to Schedule Social Media Posts from Airtable

  Drive a multi-platform publishing pipeline from an Airtable base — automation script, status writeback, and review workflow.

  An Airtable automation script posts each queued row through the API and writes the result back. Airtable caps scripts at 30 seconds per execution, so batch size and a processed marker matter more than the request itself.

• How to Manage Google Business Profile from ChatGPT or Claude

  Connect Postproxy once — a connector in Claude, a plugin in ChatGPT — and manage your Google Business Profile by talking to it: reply to reviews, set holiday hours on every location, swap photos, post offers, and ask how each location is doing.

  Postproxy is a connector in Claude and a plugin in ChatGPT. Connect it, link your Google Business Profile with a Google sign-in, and the assistant can read and reply to reviews, change opening and holiday hours, upload photos, publish posts and offers, edit menus and action buttons, and report impressions, calls, and direction requests — across every location, from a plain request.

• How to Automate Social Media with Hermes Agent

  Install the Postproxy skill in Hermes Agent, add your API key to ~/.hermes/.env, and let Hermes publish to 11 platforms from any chat app or on a schedule.

  Install the Postproxy skill, put one API key in ~/.hermes/.env, and Hermes publishes across platforms in natural language. The agent never holds platform credentials — only the Postproxy key — and per-platform failures, rate limits and retries are reported back rather than silently swallowed.

• How to Automate Social Media with OpenClaw

  Install the Postproxy skill from ClawHub, configure the API key in ~/.openclaw/.env, and let OpenClaw publish to 11 platforms from chat.

  Install the Postproxy skill in OpenClaw and publish across platforms conversationally. The assistant holds only the Postproxy API key, never platform credentials, and reports per-platform results — including rate limits and retries — instead of failing silently.

• How to Automate Social Media Posting with n8n

  Use the official Postproxy n8n integration to publish to TikTok, Threads, Pinterest, and 6 more platforms from any workflow.

  The official Postproxy n8n node publishes to TikTok, Threads, Pinterest, Bluesky and the rest from one workflow step. Platform coverage is not uniform in n8n's native nodes — LinkedIn company pages need an HTTP Request node, and Instagram has no Reels publish — which is what the Postproxy node removes.

• How to Let AI Agents Publish to Social Media via MCP

  MCP gives Claude Code, Cursor, and other LLM agents the ability to publish posts. Here's how to wire the Postproxy MCP server.

  Give Claude Code, Cursor, and other LLM agents the ability to publish posts through the Postproxy MCP server. One tool boundary turns "draft a post" into "post it" across every supported platform.

Connecting an AI agent? See the Agentic hub for Claude, ChatGPT, Cursor, Codex, Hermes, OpenClaw, and MCP.

• How to Send Messenger Quick Replies and Buttons via API

  Send tappable quick-reply chips and buttons in Facebook Messenger and Instagram DMs through one API — limits, card templates, Instagram's restrictions, and routing taps by payload.

  Send up to 13 quick-reply chips or 3 buttons with a Facebook Messenger or Instagram DM, then route each tap by the payload you chose. One API, both networks, no bot framework.

• How to Set Instagram Ice Breakers via API

  Manage the suggested questions Instagram shows when a user opens a new DM thread — set up to 4 ice breakers, receive taps as webhooks, and auto-respond by payload.

  Set up to 4 Instagram ice breakers — the suggested questions shown when someone opens a new DM thread — receive taps as webhooks, and auto-respond by payload. Capture your highest-intent DM entry point.

• How to Track ig.me and m.me Link Referrals via API

  Attribute Instagram and Messenger DM conversations to campaigns with ig.me/m.me ref parameters — referral webhooks, chat metadata, and replying before the first message.

  An ig.me link carries a ref parameter of up to 2,083 characters, letting you attribute a DM conversation to the campaign that started it. The referral fires a webhook and opens the 24-hour messaging window before the user writes — but Meta only delivers it for profiles with at least one ice breaker set.

• How to Let AI Agents Answer DMs and Comments via MCP

  Give Claude or any MCP client the tools to read and answer Instagram DMs, moderate comments, and reply to Google reviews — engagement tools on the Postproxy MCP server.

  Connect Claude or any MCP client to the Postproxy engagement tools and your AI agent can read Instagram DMs, hide or reply to comments, and respond to Google reviews directly — no copy-paste, no per-platform plumbing.

• How to Auto-Respond to Google Reviews with AI

  Wire a webhook, an LLM, and one POST into a Google review auto-responder — star-rating-aware drafts, human approval for negative reviews, multi-location routing.

  An LLM drafts a reply, the API posts it, and a webhook triggers the whole loop on each new review. Ratings-only reviews arrive with body null and star_rating set — those need a different prompt path than reviews with text.

• How to Build a Unified Social Media Inbox via API

  One chat and message schema across Facebook Messenger, Instagram DMs, Telegram, and Bluesky — list conversations, receive webhooks, and reply from a single inbox API.

  List conversations, receive webhooks, and reply across Facebook Messenger, Instagram DMs, Telegram, and Bluesky from one inbox API with a single chat and message schema — four integrations collapsed into one.

• How to Auto-Hide & Moderate Comments via API (Instagram, Facebook, Threads)

  Build automatic comment moderation — hide spam and abuse, unhide false positives, delete when needed — with one comment moderation API across Instagram, Facebook, and Threads.

  Hide spam and abuse, unhide false positives, and delete when needed across Instagram, Facebook, and Threads from one comment moderation API — automatic moderation that keeps up with any posting volume.

• How to Auto-Reply to Instagram Comments via API

  Reply to Instagram comments programmatically — comment webhooks in, replies out, with author signals for routing. One Comments API for Instagram, Facebook, and Threads.

  Reply to Instagram comments automatically from a webhook: an inbound comment event triggers a reply through the Comments API. Instagram comment replies are text-only — attaching media returns an error — and reply length is capped, so keep them short.

• How to Turn Instagram Comments into DMs via API (Private Replies)

  Build the "comment LINK to get the guide" flow with the private reply API — comment webhook in, DM out. Works on Instagram and Facebook, no ManyChat needed.

  A private reply DMs someone who commented on your post, bypassing the 24-hour messaging window for up to 7 days after the comment. Instagram allows exactly one private reply per comment — a retry that double-fires is rejected. After it lands, the normal DM window applies.

• How to Reply to Google Business Reviews via API

  List and reply to Google Business Profile reviews programmatically — multi-location filtering, star-only reviews, webhooks for new reviews, and reply management.

  Google Business Profile exposes reviews and replies, not deletion — a business can remove its own reply but never the review. Ratings without text are valid reviews and arrive with an empty comment. Multi-location accounts filter by location, and webhooks fire on new reviews.

• How to Send Facebook Messenger Messages via API

  Send and receive Facebook Messenger messages programmatically — Page chats, PSIDs, the 24-hour window, attachments, reactions, and read receipts via the Postproxy API.

  Facebook Messenger is reply-based: free-form messages are allowed only within 24 hours of the person's last inbound message. A private reply to a commenter extends that to 7 days, once per comment. Chats are keyed by PSID, and attachments send one per message.

• Instagram Direct Message API: Send, Receive, and Automate DMs

  How to send Instagram DMs via API — the 24-hour window, private replies, ice breakers, attachments, reactions and inbound webhooks, with working requests.

  Instagram messaging is reply-based: free-form DMs only within 24 hours of the user's last message. A human can reply up to 7 days out with the HUMAN_AGENT tag, and private replies to a commenter bypass the window once per comment. Cold outreach to arbitrary users is not permitted by Meta.

• How to Pull Google Business Profile Insights via API

  Read Search and Maps impressions, website clicks, call clicks, direction requests, bookings, and food orders for every Google Business Profile location as a timeseries — one endpoint, no Business Profile Performance API setup.

  Google Business Profile performance metrics — impressions on Search and Maps split by desktop and mobile, website clicks, call clicks, direction requests, conversations, bookings, and food orders — are exposed per location through the profile stats endpoints. Pass the location_id as placement_id. Snapshots are trailing 30-day totals captured daily; there is no follower count and no per-post analytics.

• How to Add "Order Online" and "Book" Buttons to Google Business Profile via API

  Create, prefer, update, and delete place action links — the Order online, Book, Reserve a table, and Shop buttons on a Google Business Profile listing — programmatically, across one location or hundreds.

  Place action links are the action buttons on a Google Business Profile listing. Each has a type (FOOD_ORDERING, DINING_RESERVATION, APPOINTMENT, SHOP_ONLINE and others), a URL, and a preferred flag. Links from aggregators like delivery platforms appear alongside the business's own and cannot be edited; the business's own link can be marked preferred so it shows first.

• How to Manage Google Business Profile Photos via API

  Upload cover, logo, interior, and gallery photos to a Google Business Profile location programmatically, list what's there, delete outdated images, and keep photo sets consistent across every location.

  Google Business Profile photos are added by URL: Google fetches the file from a public HTTPS address, so the upload call is a JSON request with media_url and a category such as COVER, LOGO, INTERIOR, or MENU. Photos must be JPG or PNG between 10 KB and 5 MB. The gallery can be listed and individual items deleted.

• How to Manage Google Business Profile Menus and Services via API

  Publish a full food menu with sections, items, and prices to a restaurant's Google Business Profile, or maintain the service list on any other business type — programmatically, with the eligibility checks that decide which one applies.

  Google Business Profile has two structured catalogues: food menus (menu → section → item → price) for restaurant-type categories, gated by canHaveFoodMenus, and the service list for everyone else, gated by canModifyServiceList. Both are replaced wholesale on update, so read first, edit, and send the complete list back.

• How to Update Google Business Profile Attributes via API

  Set payment options, accessibility, amenities, and menu or booking URLs on a Google Business Profile location programmatically — discover valid attributes first, then patch booleans, enums, and URLs without clearing the rest.

  Google Business Profile attributes are typed facts on a location: booleans, single or multi-select enums, and URLs. The set a location may use depends on its primary category and country, so list available attributes first. Updates default to a mask of exactly the attributes sent, so partial writes never clear the others.

• How to Update Google Business Profile Hours via API

  Set regular hours, holiday hours, and kitchen or delivery hours on a Google Business Profile location programmatically, mark a temporary closure, and roll the change across every location.

  Google Business Profile hours are three separate blocks on the location resource: regularHours (weekly), specialHours (date-specific overrides for holidays), and moreHours (named sets like kitchen or delivery). Each is updated with a field-masked PATCH; a temporary closure is a separate openInfo status on the location.