List your scheduled and published social media posts. Filter by status, platform, campaign, label, post type, or free text.

Get details of a specific post by ID.

Create a new social media post. Saves as draft or schedules it for a specific time. X (Twitter): nothing sent to X may contain a link (URL, bare domain or t.co) — not the post, any thread segment, or a first comment (posted to X as a reply). The X API bills each link post at $0.20 vs $0.015, so the API rejects them; put a link-free version in platformContent.twitter.

Show exactly what each platform will receive for a post: the body after platformContent overrides, the attachments after platformMedia overrides, character count vs the platform limit, whether links are clickable, and the warnings for that platform. Use this to check a post (especially carousels, videos and multi-platform posts) BEFORE scheduling or publishing. Returns structured data plus a dashboard link for the visual preview — it does not return screenshots.

Create a whole campaign of posts from one manifest. Each entry accepts the same fields as create_post; defaults supplies values shared by every entry (campaign, connectionIds, timezone, ...) so you don't repeat them. Rows are independent — one bad row fails alone and the rest still get created. Max 50 per call. Returns a per-row result with ids, warnings and edit links. X (Twitter): nothing sent to X may contain a link (URL, bare domain or t.co) — not the post, any thread segment, or a first comment (posted to X as a reply). The X API bills each link post at $0.20 vs $0.015, so the API rejects them; put a link-free version in platformContent.twitter.

List campaign bundles — every campaign tag in use, with post counts by status, the platforms involved and the next scheduled time. Use this to see what a campaign contains before editing or deleting it.

Bulk-delete posts matching a filter — e.g. every draft in a campaign. SAFETY: a filter is required (it will never delete everything), published and processing posts are always excluded, and it runs as a DRY RUN unless confirm:true. Always call once without confirm to see what matches, show the user, then confirm.

List media you already uploaded, so you can reuse an asset instead of uploading it again. Each item comes back already shaped for create_post's media array — pass it straight through.

Update a draft or scheduled post. X (Twitter): nothing sent to X may contain a link (URL, bare domain or t.co) — not the post, any thread segment, or a first comment (posted to X as a reply). The X API bills each link post at $0.20 vs $0.015, so the API rejects them; put a link-free version in platformContent.twitter.

Delete a post.

Retry the platforms that failed on a failed or partially_published post. Only failures classified transient (platform outage, rate limit, network) are re-queued; failures that need the user — reconnect an account, top up X API credits, choose TikTok visibility — or that the payload caused are refused and returned with their fix. Platforms that already went out are never re-posted. Check get_post → platformResults[].errorClass / .fix first.

The morning check: everything that needs the user's attention about delivery. Posts that failed or partially failed in the last days days with each platform's error and fix, connections whose health went dead or degraded, pending approvals whose slot is within 48 h or already passed, approvals that expired (their posts are drafts again), scheduled posts in the next 7 days that would fail preflight if dispatched now, auto-import content sources that stopped fetching, and posting queues with free slots this week while drafts wait. Same data as the 08:00 digest e-mail. Empty hasIssues: false means nothing to do.

Publish a draft or scheduled post immediately to all connected platforms. X (Twitter): nothing sent to X may contain a link (URL, bare domain or t.co) — not the post, any thread segment, or a first comment (posted to X as a reply). The X API bills each link post at $0.20 vs $0.015, so the API rejects them; put a link-free version in platformContent.twitter.

List all connected social media accounts (Instagram, Twitter, LinkedIn, etc.).

List account groups the user has set up in PlanPost (e.g. 'Polish Pages', 'English Pages'). Each group bundles social connections so you can target multiple accounts in one create_post call. Returns id, name, connectionCount, isDefault, and the underlying connections.

Fetch one account group by id, name, or default flag. Returns the group's connectionIds[] so they can be passed straight to create_post. Name matching is case-insensitive (exact match preferred, substring fallback). If the name is ambiguous the server returns 300 with the candidates.

Create a named account group (e.g. 'Polish Pages') bundling social connections, so future posts can target the whole set at once.

Update an account group's name, description, color, default flag, or replace its full connection list.

Delete an account group (does not disconnect the underlying social accounts).

Add social connections to an existing account group.

Remove social connections from an account group.

Generate a link the user can open in their browser to connect a new social account (OAuth needs a human — send them this link).

Submit a post for human approval. Use this when your API key requires approval (or whenever you want a human to sign off before publishing). Returns an approve link and an approval ID to poll. On approval the post auto-schedules if it has a scheduledFor time.

List posts waiting for approval (and their outcomes). Filter by status to build a review queue.

Check whether a human has decided on a submitted approval yet (pending / approved / rejected / changes_requested). Poll this after submit_for_approval.

Get post performance analytics — impressions, likes, comments, shares.

Get a presigned URL to upload an image or video for use in posts.

Save AI-repurposed content as draft posts. Provide an array of posts with content and target connections.

List available video templates (quotes, hooks, listicles, stories, product showcases, testimonials, promos). Each template describes its editable fields — use them with create_video.

Submit a video render job from a template. Returns a render ID — poll get_video_status until status is 'completed', then use the returned video URL as post media.

Check the status of a video render job. Completed renders include presigned download URLs for the video and thumbnail (valid ~1 hour).

Generate carousel slide TEXT (title/content/quote/CTA) from long-form content. Then call render_carousel to turn the slides into branded PNG images in the media library.

List the carousel design system: template families (with content-variant layouts), the 40-palette library (with resolved colors), output formats, font pairings, and slide caps. Use the ids with render_carousel.

Render carousel slides into branded PNG images (server-side, pixel-perfect) saved to the media library. Returns a render ID — poll get_carousel_render until 'completed'. Slide 1 uses the family's cover layout, the last slide its CTA layout, middle slides cycle content variants.

Check a carousel render job. When completed, assets are full media attachments (id/type/url/key/filename/mimeType/size, in slide order) — pass them straight into create_post's media array to draft or schedule the carousel post.

List saved brand kits (palette, font pairing, logo, handle). Use a kit's id as render_carousel's brandKitId for one-call branded output.

List connected content sources (WordPress sites, RSS feeds) used to import content for repurposing.

Connect a WordPress site or RSS feed as a content source. Imported posts can then be repurposed into social content.

Remove a content source.

Import the latest content from a source (e.g. new WordPress posts) right now, then list it with list_imported_content.

List content already imported from a source — useful as input for repurpose_content or create_post.

Get revenue analytics: totals and trend vs the previous period, recent transactions, and MRR metrics from connected providers (Stripe / RevenueCat / Shopify). Read-only.

Generate an image with AI (DALL-E) for use in posts. Costs 1 AI credit. Returns the image URL — pass it through upload_media/create_post media flow.

List the user's brand voices (tone-of-voice profiles analyzed from their content).

Get the ready-to-use system prompt for a brand voice — apply it when writing posts so the content matches the user's tone.

Get the best times to post per platform, based on the user's engagement history. Use before picking scheduledFor in create_post.

Ask the smart scheduler to spread N posts across a date range at optimal times. Returns concrete timestamps for create_post.

Read the weekly posting queue schedule: the global schedule plus any per-group overrides. Slots are {day: 1-7 (Mon=1..Sun=7), time: 'HH:MM' 24h} in the user's timezone. Groups without an override inherit the global schedule. Needs the schedule:read permission.

Replace the weekly posting queue slots for the global schedule or one account group (Pro feature; needs the schedule:write permission). Pass the FULL desired slot list — it replaces the existing one. An empty array on a group removes its override so it inherits the global schedule again.