Posteverywhere

Generate an AI image from a text prompt on PostEverywhere. The image is saved to your media library and can be attached to posts via media_ids. Choose from 4 models: gemini-3-pro (default, balanced quality, 5 credits), nano-banana-pro (photorealism, 15 credits), ideogram-v2 (good for text in images, 8 credits), flux-schnell (fastest, 1 credit). Requires the "ai" scope.

Get detailed information about a specific connected social media account on PostEverywhere. Returns the account platform, username, health status, and whether it can currently post (Pinterest also lists its boards; WordPress names its site). Use this to check the status of a single account by its ID.

Check the health of a connected social account on PostEverywhere. Returns status (healthy|warning|broken), can_post boolean, token expiry, needs_reconnection flag, recent failure count, last successful publish. Use this before publishing to detect a dead token BEFORE it causes a failed post.

Get aggregate posting metrics over a time window on PostEverywhere. Returns counts (scheduled/published/failed), per-platform breakdown, total views/likes/comments/shares/impressions/clicks across all published posts, AI credit usage, and AUDIENCE — the latest follower count per connected account plus its change over the period. One call answers "how many posts have I published this week and did my audience grow?" without listing every post. Follower snapshots begin 2026-08-31; an account with only one reading reports change_in_period as null, because a single point is not a trend.

Find the best times to post for one or more connected accounts, or for a platform. Each slot gives the weekday (ISO, 1 = Monday), the local time in the requested timezone, the next concrete datetime, a score (1.25 = about 25% better than a typical post; null for general guidance) and a basis: "personal" (measured from that account's own posts), "platform" (what works for PostEverywhere users on that platform) or "general" (guidance, not measured). Pass several account_ids to get one combined recommendation for posting to all of them. next_best is the soonest of the top three slots. Use this wh…

Get the workspace's Brand Kit from PostEverywhere (app.posteverywhere.ai/brand): what the business does, its products, audience, voice, language, rules to follow, banned words, required hashtags, colours and fonts. Call this before writing captions yourself so posts sound like the brand and follow its rules. generate_caption already writes in this brand automatically. If brand is null, no brand is set up yet and the message says where to make one.

Get details of a single campaign on PostEverywhere by its id, including post_count.

Get the signed-in PostEverywhere account: the user, the workspace, the granted scopes, the organization's plan, and what is left on each quota (accounts, AI credits, storage). Useful at the start of a conversation to learn the organization_id, scopes and quota state. While the workspace has no posts yet, next_step suggests an easy first post to offer the user.

Get detailed information about a specific media file on PostEverywhere, including its type, dimensions, file size, upload status, and aspect ratio. Use this to check if an uploaded media file has finished processing before attaching it to a post.

Get the per-platform publishing limits PostEverywhere enforces: character limit, image and video constraints (size, dimensions, duration, formats), and supported features (threads, carousels, reels, alt text, blog posts). WordPress also lists its blog post fields under platforms.wordpress.blog, and Google Business Profile its post fields (post types, buttons, event and offer fields) under platforms.google_business.local_post. Call this BEFORE composing a post for an unfamiliar platform, or when a post was rejected for length or media format — it is the difference between one correct call and a…

Get detailed information about a specific post on PostEverywhere, including its content, media attachments, schedule, and the publishing status on each destination platform. Use this to check if a post was published successfully or to see error details for failed destinations.

Get the per-platform publishing results for a specific post on PostEverywhere. Returns detailed status for each destination including published URLs, error messages, attempt counts, and retry schedules. Use this to check which platforms succeeded or failed after publishing.

Show the workspace posting queue: the recurring weekly slots it posts at, and the next openings coming up. Use this before create_post(use_queue: true) so you can tell the user exactly when their post will go out, and use it when they ask "when is my next slot" or "what does my schedule look like". The upcoming list is a FORECAST, not a reservation: a slot is only taken when a post is actually created with use_queue. If no queue is set up the queue field is null and the message explains where to create one.

Get details of a single webhook subscription on PostEverywhere (does NOT include the signing secret).

List all connected social media accounts on PostEverywhere. Returns account IDs, platform names, usernames, and health status (whether each account can currently post). Use this to see which platforms are available before creating a post. While the workspace has no posts yet, the result ends with a next_step line: offer it to the user as an easy first post.

List campaigns in the current workspace on PostEverywhere. Campaigns group related posts (e.g., "Q3 Launch", "Holiday 2026") and can be referenced via campaign_id when creating or filtering posts. Returns id, name, color, status, post_count for each.

List media files in the PostEverywhere media library. Supports filtering by type (image, video, document) and pagination. Returns file metadata including URLs, dimensions, and upload status. Use this to find existing media to attach to posts.

List scheduled, published, or draft posts on PostEverywhere. Supports filtering by status (scheduled, published, draft) and platform. Returns post content, scheduling info, and per-platform destination statuses. Use this to check what posts are queued or to review published content.

List posts on PostEverywhere with the FULL set of filters available on the API (since June 2026). Like list_posts but accepts comma-separated multi-status (e.g. "failed,partially_failed"), comma-separated platforms, date ranges (created/scheduled/published/updated), account_id and campaign_id filters, content search, and sort options. Use this for any non-trivial query — e.g. "all failed TikTok posts from last week" — that the basic list_posts can't express.

List all webhook subscriptions on PostEverywhere for the current organization. Returns id, url, subscribed events, is_active, recent delivery stats. Note: the signing secret is NEVER included in list responses.

Approval workflow: send a post waiting for review back to its author with a note saying what to change. The post stays a draft. Needs a reviewer role in the workspace.

Retry all failed platform destinations for a specific post on PostEverywhere. Resets failed destinations back to queued status so they will be re-attempted by the publishing system. Use this when a post failed due to temporary issues like rate limits or token expiry (after the token has been refreshed). Irreversible once a retry succeeds: the post becomes public on that social account, and PostEverywhere cannot recall it.

Retry all failed destinations on PostEverywhere that match a filter (account_id, platform, date range, or explicit post_ids). Saves you from making one retry call per failed post. Requires at least one filter — refuses to retry the entire failure history. Irreversible once a retry succeeds: the posts become public on those social accounts, and PostEverywhere cannot recall them.

Publish or schedule a DRAFT (created with create_post(draft: true)). Pass scheduled_for to schedule it for a future time, or publish_now: true to publish it right away. Optionally pass account_ids to set/override which accounts it posts to (defaults to the accounts saved on the draft). This is the final step of the review workflow: create_post(draft:true) → review with list_posts(status:"draft")/get_post → schedule_post. Only works on drafts — to re-time an already-scheduled post, use update_post. A draft that targets a WordPress account must have a blog title (platform_content.wordpress.setti…

Send a synthetic test ping to a webhook URL on PostEverywhere so you can verify your endpoint receives the request and validates the HMAC signature. Returns the receiver's HTTP status + duration.

Update a campaign on PostEverywhere (name, description, color, or active/archived status). Overwrites the previous values; PostEverywhere keeps no earlier version.

Update a scheduled or draft post on PostEverywhere. You can change the content, schedule time, timezone, target accounts, media attachments, or per-platform content (including a WordPress blog post's title, status, tags and categories). Only posts with status "scheduled" or "draft" can be edited — published posts cannot be modified. Returns the updated post with all its details. Fields you send replace the old values (per-platform settings are merged, see platform_content); PostEverywhere keeps no earlier version.

Update a webhook subscription on PostEverywhere — change url/events/name/description/is_active. Setting is_active=true on an auto-disabled webhook clears the consecutive_failures counter.

Import an image OR VIDEO from a public URL into the PostEverywhere media library, ready to attach to posts via media_ids. IMAGES (JPEG, PNG, GIF, WebP, HEIC, HEIF — up to 25 MB) import synchronously: the response media_id is ready immediately. VIDEOS (MP4 only — up to 4 GB) import ASYNCHRONOUSLY: the response returns media_id with media_status "uploading" right away while the file streams in server-side — poll get_media until media_status is "ready" (typically well under a minute), THEN attach it to a post. If media_status becomes "failed", get_media's error_message states exactly why (file to…