Changelog
All notable changes to the PostBoost API are documented here. Version numbers follow the OpenAPI spec and the SDK releases (the SDKs for a version are tagged v<version> in their repositories). The SDKs are released a few times a day at the latest API version, so a version released between two SDK releases has no SDK package of its own: the next SDK version includes its changes.
Base URL for all endpoints: https://postboost.co/app/api
v1.66.3 — 2026-10-23
MCP
- The free tools server (
/mcp/tools,postboost-tools) returns every tool in onetools/listresponse (up to 100 per page, was 50). Clients that read only the first page and ignorenextCursornow see all tools.
v1.66.2 — 2026-10-23
What's New
- YouTube .sbv captions: captions downloaded from YouTube Studio as
.sbvnow lose their timing lines like.srtand.vttfiles do, so the video tools read clean text instead of0:00:00.599,0:00:04.160lines.
API Changes
generateSocialPostsFromVideo: thetextdescription lists.sbv; SBV timing lines are removed before the length check and the AI call.generateYoutubeTitles,generateYoutubeDescription: thetranscriptdescription lists.sbv; SBV timing lines are removed from the captions context.
MCP
- The
generateSocialPostsFromVideo,generateYoutubeTitlesandgenerateYoutubeDescriptiontools on/mcp/postboost(and their/mcp/toolstwins) read.sbvcaptions the same way.
v1.66.1 — 2026-10-23
What's New
- Agent skill builder: the API-key skill no longer tells agents to send an idempotency key the advanced MCP server does not accept. It now says to list the workspace's posts before retrying a create that may have gone through, and to treat a
duplicate_postrefusal as "the post already exists".
API Changes
buildAgentSkill: forconnection: api_tokenthe idempotency guardrail line and the matching response example changed. The connector output is unchanged.
MCP
buildAgentSkillreturns the same new line forconnection: api_token.
v1.66.0 — 2026-10-23
What's New
- Captions as context for YouTube titles and descriptions: paste your video's captions (.srt, .vtt or the Show transcript text) next to the topic, and the titles and descriptions follow what the video actually says. Timestamps are removed and the first 6,000 characters are used; chapters still come only from your own chapter lines.
API Changes
generateYoutubeTitlesandgenerateYoutubeDescription: new optional request fieldtranscript(up to 40,000 characters). Responses are unchanged.
MCP
- The
generate-youtube-titlesandgenerate-youtube-descriptiontools take the same optionaltranscript.
v1.65.0 — 2026-10-22
What's New
- Brand voice generator: a new free AI tool reads 3 to 10 of your own posts and returns your brand voice (personality, audience, topics, tone sliders, emoji and hashtag style, calls to action and example posts) with the quotes from your posts behind each trait, as a Markdown guide, an AI system prompt and JSON in PostBoost's brand voice format. Only quotes found in your posts are kept.
API Changes
- New
generateBrandVoice(POST /tools/brand-voice-generator): sendposts(3 to 10 different posts of 20 to 3,200 characters, 20,000 in total) and optionalbusiness_nameandindustry, used as given. It returnsvoice(the workspace brand voice fields, ready forPUT /brand-voice),evidence(up to 2 quotes per trait),system_promptandmarkdown, pluscredits_spentandcached. Nothing is saved. Needs a token and spends one AI text credit; the same posts and options again are free.
MCP
- New
generateBrandVoicetool on/mcp/postboost, andgenerate-brand-voiceon/mcp/tools(listed with a token).
v1.64.2 — 2026-10-22
API Changes
deleteMediaBulkanddeleteMediaFolder(withdelete_media: true) now say that deleting a media item also removes it from every post that uses it, including scheduled posts, which then publish without it or fail where the network requires media. Behaviour is unchanged.
MCP
- The
deleteMediaBulkanddeleteMediaFoldertool descriptions carry the same warning.
v1.64.1 — 2026-10-22
API Changes
previewPost: the X card now shows images whole from 3:4 to 2:1 (was 4:5 to 2:1), somin_ratiois3:4and a 3:4 photo is no longer reported as cropped. Taller images crop to 3:4.
v1.64.0 — 2026-10-22
What's New
- YouTube video to social posts: a new free AI tool turns a video's captions (an .srt or .vtt file, or the text under Show transcript) into an X thread and up to three captions for LinkedIn, Instagram, Facebook, Threads, Bluesky or Mastodon in one run. Timestamps, cue numbers and sound tags are removed first. Each output fits its network's limit and links the video once.
API Changes
- New
generateSocialPostsFromVideo(POST /tools/youtube-to-social-posts): sendtext(the captions) and optionalvideo_url(a YouTube watch, youtu.be, Shorts or live link),title,outputs(1 to 4 ofx_thread,linkedin,instagram,facebook,threads,bluesky,mastodon) andtone. It returnsoutputs(the thread as an array of posts, each caption as a string),outputs_skipped,warnings, the normalisedvideo_url,cleaned_charsandremoved_timestamps, pluscredits_spentandcached. The video is never fetched. Needs a token and spends one AI text credit; the same captions and options again are free.
MCP
- New
generateSocialPostsFromVideotool on/mcp/postboost, andgenerate-social-posts-from-videoon/mcp/tools(listed with a token).
v1.63.0 — 2026-10-22
What's New
- LinkedIn carousel maker: a new free tool turns a post or an outline into LinkedIn carousel slides (1080×1350 or 1080×1080) and downloads them as one PDF for a document post, in the browser, with no watermark. Choose the most slides, a cover and a call-to-action slide, a light or dark theme, an accent colour and a footer with your name and @handle.
API Changes
- New
buildLinkedinCarousel(POST /tools/linkedin-carousel-maker): sendtextand optionalmax_slides(3-20),size(4:5or1:1),coverandcta. It returns the slide outline:page(width and height in pixels),slides(n,kindcover/content/cta,heading,bodylines),warnings(too_many_slides,split_block) andlimits. The PDF itself is built on the tool page. Nothing is stored. Anonymous, within the standard free-tools limits.
MCP
- New
buildLinkedinCarouseltool on/mcp/postboost, andbuild-linkedin-carouselon/mcp/tools.
v1.62.0 — 2026-10-21
What's New
- Social media agent skill builder: a new free tool that builds a SKILL.md, AGENTS.md or system prompt for an agent that runs social media through PostBoost. You pick the tasks, the networks and how much the agent may do on its own (drafts only, ask before scheduling, or queue without asking); the file names the connector's real tools and adds guardrails such as a daily cap and validation before every write.
API Changes
- New
buildAgentSkill(Free Tools API,POST /tools/social-media-agent-skill-builder): returns the file'scontent,filename,installsteps, the connector tools it names (tools_used), itslinesandwarnings. No account needed.
MCP
buildAgentSkillon/mcp/postboostandbuild-agent-skillon/mcp/toolsreturn the same file.
v1.61.1 — 2026-10-21
What's New
- Cross-post formatter, Threads links: links count once each, as Threads counts them (trailing punctuation trimmed). When a text splits into a Threads thread, each post is checked on its own, and the warning names the post that has more than 5 links.
API Changes
formatCrossPost(Free Tools API):networks[].linksis now the number of uniquehttp(s)://links. On Threads, a text that splits into a thread gets onethreads_too_many_linkswarning per post over 5 links, and none for the whole text.
MCP
formatCrossPoston/mcp/postboostandformat-cross-poston/mcp/toolsreturn the same counts and warnings.
v1.61.0 — 2026-10-21
What's New
- LinkedIn first-comment warning: when LinkedIn first comments are not enabled on the server, a LinkedIn post with a second content item now says so instead of dropping the comment silently. The post itself still publishes.
API Changes
createPost,updatePostandvalidatePost: new warning codelinkedin_first_comment_unavailableon the LinkedIn profile or Page account whose version has a first comment that will not be posted.- The
contentdocs now state that LinkedIn posts the second item as the first comment only when first comments are enabled for LinkedIn on the server.
MCP
createPost,updatePostandvalidatePoston/mcp/postboostreturn the same warning.
v1.60.0 — 2026-10-21
What's New
- Threads link limit: Threads rejects a post with more than 5 different links. Creating, updating or validating a post now warns before Threads would reject it, and the pre-publish checker flags it on scheduled posts. Each post of a reply chain is checked on its own.
API Changes
createPost,updatePost,validatePost: newwarnings[].codevaluethreads_too_many_links(a Threads account's post has more than 5 differenthttp(s)://links). The post is still saved.PostWarning.codeis now an extensible list (x-extensible-enuminstead ofenum): new warning codes will be added without notice, so treat an unknown code as a warning and log it. In the generated SDKscodeis a plain string, so a newer code no longer fails to deserialize in an older SDK.
MCP
- The
validatePosttool on/mcp/postboostand the connector's post checks return thethreads_too_many_linkswarning.
v1.59.0 — 2026-10-21
What's New
- Giveaway comment picker: a new free tool draws giveaway winners and alternates from pasted comments or a CSV, in the browser, with no comment cap. It filters by one entry per person, keywords, a minimum number of @mentions and excluded usernames. The draw uses commit-reveal (
pb-draw-v1): publish the seed's fingerprint when you announce the giveaway and the seed after the draw, and anyone can re-run it on the "Verify a draw" tab.
API Changes
- New
pickGiveawayWinners(POST /tools/giveaway-comment-picker): sendentrants(username, optionalcomment), an optionalseed(64 hex characters),one_per_person,keywords,min_mentions,exclude,winners(1-100) andalternates(0-20). It returnswinners,alternates,entrants_before,entrants_after,entrant_list(the canonical list to publish),entrants_hash,fingerprint,seed,pre_committed(falsewhen the seed was generated for the call),algorithmandwarnings(not_enough_entrants,not_pre_committed). Nothing is stored. Anonymous, within the standard free-tools limits and the 128 KB body cap. countCharacters,splitThreadandformatCrossPost: a text that starts with a byte-order mark (U+FEFF, which some copy and paste sources add) no longer fails on X. X counts ignore byte-order marks, and a link right after one is counted as plain text, as X's own counting rules do.splitThreadandformatCrossPost: non-breaking and ideographic spaces at the start or end of a paragraph are trimmed, and words split on them. The threads now match the ones the web tools show.
MCP
- New
pickGiveawayWinnerstool on/mcp/postboost, andpick-giveaway-winnerson/mcp/tools. - The same fixes apply to the matching tools on
/mcp/postboostand/mcp/tools.
v1.58.0 — 2026-10-21
What's New
- Cross-post formatter: a new free tool shows one post on X, Threads, Bluesky, Mastodon and LinkedIn side by side. Each network counts with its own rules. The tool warns about more than 5 links on Threads, the LinkedIn "see more" fold and @handles that do not carry over, and gives a ready thread wherever the post is too long.
API Changes
- New
formatCrossPost(POST /tools/cross-post-formatter): sendtext, optionalnetworks(x,threads,bluesky,mastodon,linkedin; default all five, in the order you list them) andnumbering. Each network returnscount,limit,fits,over_by,links,warnings(threads_too_many_links,cut_by_fold,mentions_not_portable) andthread(the split posts when the text does not fit;nullwhen it fits or on LinkedIn). Anonymous, within the standard free-tools limits.
MCP
- New
formatCrossPosttool on/mcp/postboost, andformat-cross-poston/mcp/tools.
v1.57.8 — 2026-10-20
What's New
- Pixelfed expiry warnings: Pixelfed accounts now get the 7, 3 and 1-day expiry email and the
account.token_expiringwebhook before their access token ends (365 days after you connect by default; each server sets its own).
API Changes
getAccountHealth: Pixelfed accounts reportexpiry_kindaccesswithexpires_atanddays_left, instead ofnone.
v1.57.7 — 2026-10-20
API Changes
getXUsage: the description now says that scheduling to X is refused with429(code: x_monthly_cap_reached) only once enforcement is switched on (enforced: true). Until then usage is tracked only. No behaviour change.
v1.57.6 — 2026-10-20
API Changes
- Social media post checker: the Instagram
link_not_clickablewarning now suggests the bio or a Story link sticker.
v1.57.5 — 2026-10-20
API Changes
countCharacters,checkPostandsplitThread: the Mastodon count weighs only links that start withhttp://orhttps://as 23 characters. A bare domain such asexample.com/blog/spring-launchnow counts at its full length, as Mastodon counts it; before, it counted as 23, so a post near the limit could show as fitting and be refused by the server. X counting is unchanged.
MCP
- The connector tools
count-charactersandcheck-post, and the spec-generated tools for these operations, count Mastodon the same way.
v1.57.4 — 2026-10-19
API Changes
getSafeZones: the TikTok boxes are now measured from TikTok's own In-Feed safe-zone template, andsource.basissays so: a 120 px action rail next to the 80 px right margin at 720 × 1280 (200 px from the edge), scaled to 1080 × 1920. The boxes are unchanged;last_verifiedis2026-10-19.
v1.57.3 — 2026-10-19
API Changes
blogToSocial: captions now fit each network's real text limit, andcharacter_limitreports it: Threads 500, Google Business Profile 1500, Bluesky 300, Pixelfed 500, Facebook groups 5000, and Instagram accounts connected with Instagram Login 2200, the same as other Instagram accounts. Before, Threads and Google Business Profile captions could run to 5000 characters and fail at publish.
v1.57.2 — 2026-10-19
API Changes
createPost,updatePostandvalidatePost: an Instagram account connected with Instagram Login (instagram_standalone) no longer gets a falseinstagram_image_ratiowarning on a Story or Reel. The post type is now read fromoptions.instagram_standalone.typefor those accounts, as the publisher does. Their feed posts are still checked.
MCP
createPost,updatePostandvalidatePoston/mcp/postboostreturn the corrected warnings.
v1.57.1 — 2026-10-19
API Changes
PostContent.urldocs: the link also sets the Facebook Page link card (Facebook builds the card from the page's own Open Graph tags), not only LinkedIn and Bluesky.
v1.57.0 — 2026-10-18
What's New
- Instagram bio, YouTube title and LinkedIn headline generators: three new free AI tools write five short drafts each, every one within the network's limit (150, 100 and 220 characters, counted like the character counter). The web pages also offer a formula and fill-in templates that work without AI.
- YouTube description generator: a new free AI tool writes three description drafts with the hook in the first lines, your keywords used naturally and
[link]placeholders instead of invented links. Each fits YouTube's limit of 5,000 UTF-8 bytes. Chapters are your own time and title lines, added as written; the tool never makes up times. The web page also offers a fill-in template that works without AI. - Social media manager pricing calculator on the Free Tools API: the maths behind postboost.co/tools/social-media-manager-pricing-calculator: monthly hours, a retainer, a per-post price and a ±20% range from your workload and your own hourly rate, with every assumption listed.
- Webhook signature verifier: a new free tool checks an HMAC webhook signature (SHA-256, SHA-1 or SHA-512, hex or base64, optional prefix such as
sha256=) against the raw body and secret. The web page computes it in the browser and sends nothing. When a signature does not match, it names the usual mistake that would make it match: a trailing newline, a re-encoded JSON body, a prefix left on, whitespace around the secret, the wrong encoding or algorithm. Presets for PostBoost (X-Signature) and GitHub (X-Hub-Signature-256). - Social media username generator on the Free Tools API: the generator behind postboost.co/tools/social-media-username-generator: 30 username ideas from a name or keywords, each within the chosen network's length and character rules, with a profile link per idea. Availability is not checked.
- Social media glossary: more than 110 social media terms in plain language, from reach and engagement rate to ad metrics, webhooks and MCP, searchable by text and filterable by category. Each platform rule or number links to its source, and each term links to its place on the glossary page.
- Alt text generator: a new free tool writes alt text for an image (short, up to 125 characters, or detailed, up to 250) plus a shorter alternative, so screen reader users get a description of what matters. The image is read once and never stored. The web page also has an alt text checklist that works without AI.
- Social media report generator: a new free tool turns a CSV of post metrics into a one-page report: posts, views, engagements and engagement rate, a table per network, the top 5 posts and the best weekday. Copy it as text, download it as CSV or print it to PDF. The CSV is read in the browser and never uploaded; a CSV exported from PostBoost's reports maps with no changes.
- Hashtag group builder: a new free tool cleans a messy list of hashtags or keywords (adds the missing
#, cuts tags at punctuation, drops duplicates and number-only tags), checks the network's hashtag cap and splits the tags into copy-ready groups, on one line or as a first-comment block. - Social media tool picker: a new free tool matches what you need (a team dashboard, a REST API with an OpenAPI spec, SDKs, MCP, webhooks, a free hosted plan, a native Zapier, n8n or Make app) against PostBoost and the tools on our comparison pages, and shows what each one meets, misses or does not document, with the date the data was checked.
- Social media automation recipes: eight step-by-step recipes for n8n, Zapier and Make that post through the PostBoost API with each platform's generic HTTP step: RSS to the queue, RSS to AI caption drafts, Google Sheets and Airtable rows to scheduled posts, Drive videos to Reels, TikTok and Shorts drafts, Slack approval, a failed-post alert and a weekly analytics digest. Each lists the API operations it calls; for n8n it also returns an importable workflow that uses only built-in nodes.
- LinkedIn posts from the API:
generateCaptionnow writes the same long-form LinkedIn posts as the LinkedIn post generator page. Passnetwork: "linkedin"andformat: "post".
API Changes
- New
generateBio(POST /tools/instagram-bio-generator): five Instagram bios by tone, with or without emoji and a call to action. Needs a token and spends one text credit per call, likegenerateCaption. - New
generateYoutubeTitles(POST /tools/youtube-title-generator): five YouTube titles in one style (how-to, listicle, question, story, news), main keyword first, never in capitals and without<or>. - New
generateLinkedInHeadline(POST /tools/linkedin-headline-generator): five LinkedIn profile headlines from a role, skills and an optional audience, by tone. - Each returns three to five variants; a reply with fewer usable ones is an error and spends no credit.
- New
generateYoutubeDescription(POST /tools/youtube-description-generator): three YouTube descriptions from a summary (up to 1,000 characters), optional keywords, optionalchapter_lines(first at 0:00, at least three, in time order, at least 10 seconds apart) and acta(subscribe, link or none). Needs a token and spends one text credit per call, likegenerateCaption. A reply with fewer than two usable descriptions is an error and spends no credit. - New
calculateSmmPricing(POST /tools/social-media-manager-pricing-calculator): inputnetworks,posts_per_week,content_type(copy,copy_design,copy_design_video),community_hours_per_week,reporting_hours_per_month,ad_hours_per_month,hourly_rate,currency(USD,EUR,GBP, formatting only) andpricing_model(hourly,retainer,per_post); outputposts_per_month,hours_per_month,hourly_rate,monthly_retainer,per_post,range(low,high),line_itemsandassumptions. No token needed. - New
verifyWebhookSignature(POST /tools/webhook-signature-verifier): returnsvalid, theexpectedsignature andhints. Anonymous within the standard free-tool limits. It runs on our server, so send only test secrets and sample payloads; the body and secret are never logged or stored. - New
generateUsernames(POST /tools/social-media-username-generator): inputname(up to 60 characters),network(instagram,tiktok,x,youtube,threads),style(clean,creative,business,gaming),numbersandseed(the same input and seed return the same list); outputusernames(username,profile_url) and the network'srules(min_length,max_length,separators). No token needed. getGlossary(GET /tools/social-media-glossary): new free operation. Optional queryq(text in the term or its definition) andcategory(metrics,content,ads,platforms,developer,strategy). No token needed; the standard free-tool limits apply.- New
generateAltText(POST /tools/alt-text-generator): send the image asimage_base64in JSON, upload it asimagein amultipart/form-databody, or give a public httpsimage_url. JPEG, PNG, WebP or GIF (first frame) up to 5 MB; the type is read from the bytes, not the file name. Needs a token and spends one text credit per new image; the same image with the same options again is free. - This operation accepts request bodies up to 7 MB (the other free tools keep 128 KB). An
image_urlthat points to a private address is refused, and each URL fetch counts against the daily limit of the tools that load a URL. PostContent.urlis now described: the link shown as a preview card on LinkedIn and Bluesky. When a content item has nourland no media, create, update and validate use the first link inbody, as the web composer does, so API and RSS posts get the same link card. Aurlyou send is never changed.- New
summarizeReport(POST /tools/social-media-report-generator): send up to 5,000rows, one object per post withdate,network,textand the countsviews,likes,comments,shares,clicksandengagements(whole numbers up to 100 billion; leave out the ones you do not have). The response has the totals,engagement_rate(nullwithout views),networks,top_posts,weekdaysandbest_weekday. No token needed. - This operation accepts request bodies up to 2 MB (most free tools keep 128 KB). An invalid row is reported per field, for example
rows.3.views. - New
buildHashtagGroups(POST /tools/hashtag-group-builder): returns the cleanhashtags, theremovedentries with a reason (duplicate,digits_only,empty,too_long), the network'scap(null= no hard limit), thegroup_sizeused, thegroups(tags, text, characters) andover_cap. Anonymous, within the standard free-tools limits. - New
pickSocialMediaTool(POST /tools/social-media-tool-picker): sendneeds(or ause_caseshortcut) and get every tool inresultswith itsscore,matched,missingandunknownneeds, thecompare_urlof its full comparison,checked_at,pick_ifandpostboost_if, sorted by score, then name. Anonymous, within the standard free-tools limits. findAutomationRecipes(GET /tools/social-media-automation-recipes): new free operation. Optional queryplatform(n8n,zapier,make),trigger(rss,spreadsheet,file,approval,webhook,schedule) andq(text in the title or goal).n8n_workflowis filled only whenplatformisn8n. No token needed; the standard free-tool limits apply.generateCaption(POST /tools/instagram-caption-generator) takes an optionalformat:caption(default, unchanged) orpost. A post is 300-600, 600-1,300 or 1,300-2,000 characters bylength, with at most 3 hashtags.format: "post"works withnetwork: "linkedin"only; any other network returns 422 and spends no credit.- A call without
formatgives the same captions as before. getRemoteUploadStatus: thestatusvalues now match what the API sends:pending,downloading,processing,completedandfailed(the spec saidcomplete, which was never sent). The response documentsprogress(0 to 100) anderror(whenstatusisfailed), and the new404response (status: failedwith anerror) for an unknown download id, one older than an hour, or one whose final result was already returned.initiateRemoteUpload: the response is200(the spec said201). Its body isstatus: completedwith themediaobject,status: failedwith anerror, orstatus: pendingwith adownload_idto poll. The spec described a bareMediaobject, which was never sent.- SDK upgrade:
InitiateRemoteUpload201Responseis nowInitiateRemoteUpload200Response, andGetRemoteUploadStatus404Responseis new. When pollinggetRemoteUploadStatus, check forcompleted(notcomplete).
MCP
- The three operations are new tools on
/mcp/postboostand/mcp/tools. - The operation is a new tool on
/mcp/postboostand/mcp/tools. - New
calculateSmmPricingtool on/mcp/postboost, andcalculate-smm-pricingon/mcp/tools. - New
verifyWebhookSignaturetool on/mcp/postboost, andverify-webhook-signatureon/mcp/tools. - New
generateUsernamestool on/mcp/postboost, andgenerate-usernameson/mcp/tools. - New
getGlossarytool on/mcp/postboost, andget-glossaryon/mcp/tools. generate-alt-textis a new tool on/mcp/postboostand/mcp/tools. On/mcp/toolsa request with a token may now be up to 1.5 MB, enough for an image of about 1 MB asimage_base64; send larger images asimage_url.summarize-reportis a new tool on/mcp/postboostand/mcp/tools. On/mcp/toolsa request is capped at 128 KB without a token and 1.5 MB with one; send bigger reports to the API.- New
buildHashtagGroupstool on/mcp/postboost, andbuild-hashtag-groupson/mcp/tools. - New
pickSocialMediaTooltool on/mcp/postboost, andpick-social-media-toolon/mcp/tools. - New
findAutomationRecipestool on/mcp/postboost, andfind-automation-recipeson/mcp/tools. generate-captionon/mcp/toolsandgenerateCaptionon/mcp/postboostacceptformat.- The
initiateRemoteUploadandgetRemoteUploadStatustools describe the same responses.
v1.56.0 — 2026-10-17
What's New
- Social media holiday calendar on the Free Tools API: the data behind postboost.co/tools/social-media-holiday-calendar: public holidays, awareness days, weeks and months and social media days from November 2026 to December 2027, each with the official or organiser page its date comes from and a one-line post idea.
API Changes
- New
listAwarenessDays(GET /tools/social-media-holiday-calendar): optional queryfromandto(YYYY-MM-DD; entries that overlap the range),country(a country code; worldwide entries are included),type(public-holiday,awareness-day,awareness-week,awareness-month,social-media-day) andtopic; outputcovers(from,to),total,entries(name,type,date,end,countries,topics,source,note,idea),last_verifiedandsources. No token needed.
MCP
- New
listAwarenessDaystool on/mcp/postboost, andlist-awareness-dayson/mcp/tools.
v1.55.1 — 2026-10-17
What's New
- TikTok and LinkedIn presets for the AI writing tools: new free web tools (TikTok hashtag generator, TikTok caption generator, LinkedIn post generator) run the same generators as the Instagram tools. On the API,
network: "tiktok"now tunes the output for TikTok the same way.
API Changes
generateHashtags: withnetwork: "tiktok"it returns 3 to 6 hashtags (was up to 10); other networks still get 5 to 10. Thehashtagsdescription says so.generateCaption: withnetwork: "tiktok"each caption opens with a short hook line. Thecaptionsdescription says so.
v1.55.0 — 2026-10-17
What's New
- Social media audit scorecard on the Free Tools API: the logic behind postboost.co/tools/social-media-audit-template: answer an eight-question yes / partly / no checklist per network and get a 0-100 score per network and overall, the three weakest questions as top fixes with a tip each, and the scorecard as a Markdown report.
API Changes
- New
scoreSocialAudit(POST /tools/social-media-audit-template): inputtarget_posts_per_week(1 to 50, default 3) and one object per audited network (instagram,facebook,linkedin,x,tiktok,youtube,pinterest,threads,bluesky,mastodon) withyes,partlyornoforprofile,bio,link_tracking,frequency,replies,native_formats,pinnedandengagement_rate(a missing answer counts asno); outputscore,networks(network,label,score,points,max_points,itemswithkey,question,answer,points),top_fixes(key,question,tip,networks) andreport_markdown. No token needed.
MCP
- New
scoreSocialAudittool on/mcp/postboost, andscore-social-auditon/mcp/tools.
v1.54.0 — 2026-10-17
What's New
- Dry run shows publish-time warnings:
posts/validatenow returns the samewarningsas create-post, so a Threads post over 500 characters as Threads counts them, a YouTube description over 5,000 bytes,<or>in a YouTube title, or an Instagram feed image outside 4:5 to 1.91:1 shows up before you schedule instead of failing at publish.
API Changes
validatePost: new required fieldwarnings(array ofPostWarning, always present, empty when there is nothing to say).validkeeps its meaning: warnings do not make a post invalid.
MCP
- The connector's
validate-posttool returnswarningsand its description says so.
v1.53.1 — 2026-10-17
MCP
- The connector's
get-post(withcontent_urls) returnsurl: nullfor a content item without a link, andget-accountreturnsdata: {}for an account without provider data, matching the REST API. Webhook payloads keep""and[]for these two values; the webhooks page says how to read them.
v1.53.0 — 2026-10-17
What's New
- Safe zone checker on the Free Tools API: the boxes behind postboost.co/tools/safe-zone-checker. Give a platform (TikTok, Instagram Reels or YouTube Shorts) and, optionally, a frame size, and get the areas the app's own interface usually covers plus a safe area for text and faces. The numbers are approximate: they come from each platform's guidance for vertical video ads, with the source and the date they were last checked in every answer.
API Changes
- New
getSafeZones(POST /tools/safe-zone-checker): inputplatform(tiktok,instagram_reelsoryoutube_shorts) and optionalwidthandheight(default 1080 × 1920); outputunsafe_areas(name,label,x,y,w,h),safe_area,source(label,url,basis),last_verified,caveatandwarnings. Boxes are scaled from 1080 × 1920 and their edges rounded to the nearest pixel. An unknown platform returns 422. No token needed.
MCP
- New
getSafeZonestool on/mcp/postboost, andget-safe-zoneson/mcp/tools.
v1.52.0 — 2026-10-17
What's New
- Influencer rate calculator on the Free Tools API: the logic behind postboost.co/tools/influencer-rate-calculator: give a network, follower count and deliverable, and get the sourced price-guide range for that tier next to the measured marketplace median, with deliverable, usage-rights and exclusivity adjustments and the source of every number.
API Changes
- New
calculateInfluencerRate(POST /tools/influencer-rate-calculator): inputnetwork(instagram,tiktok,youtube,x,facebook),followers, optionaldeliverable,avg_views(required on YouTube),cpm_usd,usage_rights_months(0 to 24) andexclusivity; outputtier,tier_label,deliverable,guide_low,guide_high(null when open-ended),guide_source,marketplace_median,marketplace_note,marketplace_source,cpm_estimate,multipliers,method,warnings,currencyandlast_verified. No token needed.
MCP
- New
calculateInfluencerRatetool on/mcp/postboost, andcalculate-influencer-rateon/mcp/tools.
v1.51.0 — 2026-10-17
What's New
- Instagram carousel splitter on the Free Tools API: the cut-line maths behind postboost.co/tools/instagram-carousel-splitter. Give an image size, a slide count and a slide shape, and get the crop box of every slide in source pixels, so a wide image or panorama becomes a seamless carousel. Only the image size is sent, never the image.
API Changes
- New
calculateCarouselSlices(POST /tools/instagram-carousel-splitter): inputwidthandheight(source pixels),slides(2 to 10) andratio(1:1or4:5, default4:5); outputslides(x,y,width,heightper slide, left to right),output(slide size in pixels),scale,upscaledandwarnings. A source narrower than the slide count returns 422. No token needed.
MCP
- New
calculateCarouselSlicestool on/mcp/postboost, andcalculate-carousel-sliceson/mcp/tools.
v1.50.0 — 2026-10-17
What's New
- Posting frequency planner on the Free Tools API: the logic behind postboost.co/tools/posting-frequency-planner: give your networks and how many posts your team can make in a week, and get each network's sourced posts-per-week range (with source, date and evidence type), your posts split across the networks, a weekly grid and warnings.
API Changes
- New
planPostingFrequency(POST /tools/posting-frequency-planner): inputnetworks(1 to 9 ofinstagram,facebook,linkedin,x,tiktok,youtube,pinterest,threads,google_business_profile) andposts_per_week_capacity(1 to 200); outputposts_per_week_capacity,sum_of_minimums,networks(network,label,recommended_per_weekwithminandmax, null for an open-ended range,recommended_label,allocated_per_week,fit,source_type,sources),slots(weekday,network,label),warningsandlast_verified. No token needed.
MCP
- New
planPostingFrequencytool on/mcp/postboost, andplan-posting-frequencyon/mcp/tools.
v1.49.0 — 2026-10-16
What's New
- Post readability checker on the Free Tools API: the logic behind postboost.co/tools/post-readability-checker: give a post and get its Flesch reading ease and Flesch-Kincaid grade, the sentences of more than 25 words, possible passive phrases and plain suggestions. Hashtags, @mentions, links and emoji are not counted as words.
API Changes
- New
checkReadability(POST /tools/post-readability-checker): inputtext(1 to 10,000 characters) and optionallanguage(onlyenis scored; another language returnssupported: false, anoteand no scores); outputsupported,note,flesch_reading_ease,flesch_kincaid_grade,sentences,words,syllables,avg_words_per_sentence,long_sentences(index,words,excerpt),passive_hints,emoji_count,hashtag_countandsuggestions. No token needed.
MCP
- New
checkReadabilitytool on/mcp/postboost, andcheck-readabilityon/mcp/tools.
v1.48.0 — 2026-10-16
What's New
- X API cost calculator on the Free Tools API: the logic behind postboost.co/tools/x-api-cost-calculator: give what your app posts and reads on X in a month and get the pay-per-use bill line by line, with the extra that link posts cost and the date X's prices were last checked.
API Changes
- New
calculateXApiCost(POST /tools/x-api-cost-calculator): inputposts,link_share(percent of posts with a URL, 0-100),replies,post_reads,user_reads,owned_reads(whole numbers, all optional); outputline_items(count × unit price per resource),total_usd,link_premium_usd,notes,prices_last_verifiedandsource. No token needed.
MCP
- New
calculateXApiCosttool on/mcp/postboost, andcalculate-x-api-coston/mcp/tools.
v1.47.0 — 2026-10-16
What's New
- Emoji search on the Free Tools API: the logic behind postboost.co/tools/social-media-emoji-picker: search 1,898 emoji (Emoji 15.1 and older, so they render on current phones) by Unicode name or CLDR English keyword, optionally within one of 9 categories.
API Changes
- New
searchEmoji(POST /tools/social-media-emoji-picker): inputquery(up to 50 characters; empty lists the category in Unicode order), optionalcategoryandlimit(1 to 100, default 30); outputresults(emoji,name,keywords,category,unicode_version) andtotal. An unknown query returns an emptyresultslist, not an error. No token needed.
MCP
- New
searchEmojitool on/mcp/postboost, andsearch-emojion/mcp/tools.
v1.46.0 — 2026-10-16
What's New
- Social media ROI calculator on the Free Tools API: the logic behind postboost.co/tools/social-media-roi-calculator: give the revenue social media brought in and what it cost, and get the ROI, the net return and each cost's share, with the formula written out.
API Changes
- New
calculateSocialRoi(POST /tools/social-media-roi-calculator): inputrevenue(USD), optionalcosts(ad_spend,tools,labor_hours,hourly_rate,content,other, all 0 or more) andperiod; outputtotal_cost(labor = hours × hourly rate),net_return,roi_percent((revenue − total cost) ÷ total cost × 100, 1 decimal,nullwhen the total cost is 0),cost_breakdown,warningsandformula. No token needed.
MCP
- New
calculateSocialRoitool on/mcp/postboost, andcalculate-social-roion/mcp/tools.
v1.45.0 — 2026-10-16
API Changes
- Posts (
getPost,listPosts,createPost,updatePostand every other response that contains a post): a content item without a link returnsurl: nullinstead of an empty string, which the spec'suriformat rejected. Requests still accept"". - Accounts (
listAccounts,getAccountand accounts inside post responses, also for keys limited to some accounts): an account without provider data returnsdata: {}instead of[], matching theobjecttype in the spec. ScheduleResult.scheduled_at(schedulePost,addPostToQueue,approvePost) is documented in the format it has always had (Y-m-d H:i:s, UTC), not RFC 3339date-time.Workspace.created_at,User.created_at,User.email_verified_at,Subscription.trial_ends_at,paused_from,ends_at,Receipt.created_atandpaid_atare documented as the display strings they have always been (for exampleOct 16, 14:05orOct 16, 2026, in the configured timezone), not RFC 3339date-time.- Upgrade note, typed SDKs: those 9 fields change type from a date to a string (Go
time.Time→string, JavaOffsetDateTime→String, Pythondatetime→str, TypeScriptDate→string, PHP\DateTime→string). Go and Java could not parse these values before; TypeScript, Python and PHP code that treats them as dates must parse the string itself. - Upgrade note, untyped clients: a post content item's
urlcan now benull. Code that runs string operations on it (an n8n expression,.length,.startsWith()) needs a null check.
v1.44.0 — 2026-10-16
What's New
- Content calendar generator on the Free Tools API: the logic behind postboost.co/tools/social-media-content-calendar-generator: give a start date, the weeks to plan and posts per week per network, and get every post's date and time, spread evenly over each week, with your content pillars rotated over the posts, plus the plan as a CSV file and as an iCalendar (.ics) file.
API Changes
- New
planContentCalendar(POST /tools/social-media-content-calendar-generator): inputstart_date(YYYY-MM-DD),weeks(1 to 12, default 4),posts_per_week(per network, 0 to 14), optionaltimes(per network, HH:MM, default 10:00) andpillars(up to 6 themes); outputend_date,total,slots(date, weekday, time, network, network_label, pillar),csv(UTF-8 with BOM) andics(one 15-minute event per post, floating local time). A plan with no posts is a 422. No token needed.
MCP
- New
planContentCalendartool on/mcp/postboost, andplan-content-calendaron/mcp/tools.
v1.43.0 — 2026-10-16
What's New
- Instagram image ratio warning: a post whose Instagram feed image is outside 4:5 to 1.91:1 (a 3:4 phone photo, a 9:16 screenshot) now gets a warning before it is scheduled, because Instagram rejects such images at publish time. The post is still created; crop the image to 4:5.
API Changes
- New warning code
instagram_image_ratioin thewarningsof post create and update responses: one per Instagram account whose feed post (single image or carousel) has images outside 4:5 to 1.91:1. Reels, Stories, videos and GIFs are not checked.
MCP
- The same warning in the create and update post tool results.
v1.42.1 — 2026-10-16
API Changes
countCharactersandcheckPostnow count Bluesky and Mastodon posts per grapheme, as the free tool pages do: every emoji counts 1, including Emoji 13 and later (🫶, 🥹, 🫠, 🩷, 🪿), skin-tone variants and new ZWJ sequences such as 🐦🔥, which counted 2 to 5 before. Links still count as before (Bluesky shortens them, Mastodon counts 23).
MCP
- The same counts on the
countCharacters/checkPosttools of/mcp/postboostandcount-characters/check-poston/mcp/tools.
v1.42.0 — 2026-10-16
What's New
- Instagram line break generator on the Free Tools API: the logic behind postboost.co/tools/instagram-line-break-generator: give a caption and get it back with one spacer character on each blank line, so the gap between paragraphs stays when you paste it into Instagram, counted against the 2,200 character limit and the 5 hashtags PostBoost allows per Instagram post.
API Changes
- New
formatInstagramCaption(POST /tools/instagram-line-break-generator): inputtext(up to 10,000 characters), optionalspacer(braille= U+2800 Braille blank, default, ordot) andhashtags_to_end(move the hashtags that end a line to the bottom after three spacer lines); outputtext,count,limit,over,hashtagsandmax_hashtags. Spaces at line ends and blank lines at the start and end are removed. No token needed.
MCP
- New
formatInstagramCaptiontool on/mcp/postboost, andformat-instagram-captionon/mcp/tools.
v1.41.0 — 2026-10-16
What's New
- Blog to social on the Free Tools API: the AI behind postboost.co/tools/blog-to-social-media: give a blog post's URL (or its text) and up to 4 networks, and get one post per network, written with the same prompts as the web tool. Needs an API token; each post spends 1 AI credit of your workspace.
API Changes
- New
generateSocialPostsFromBlog(POST /tools/blog-to-social-media): inputurl(public http or https) ortext(up to 20,000 characters),platforms(1 to 4 offacebook,instagram,x,linkedin,pinterest,youtube,tiktok,mastodon), optionaltone,length,hashtags,ctaandworkspace; outputposts(platform,text,hashtags,characters,limit),source(title,final_url, only withurl),warningsandcredits_spent. Private, local and metadata addresses are a 422 with no request made. A call finishes within the request time budget: networks whose reply does not come back in time are left out with aplatforms_skippedwarning and are not charged; when none comes back the answer is a 502. Token only, like the other paid AI tools. - The workspace API's
blogToSocial(drafts in a workspace) is unchanged.
MCP
- New
generateSocialPostsFromBlogtool on/mcp/postboost, andgenerate-social-posts-from-blogon/mcp/tools(listed only with a token).
v1.40.0 — 2026-10-16
What's New
- YouTube thumbnail checks on the Free Tools API: the rules behind postboost.co/tools/youtube-thumbnail-size-checker: give a thumbnail's width, height, file size and format and get a pass or fail per YouTube requirement. No account needed.
- Social media video specs on the Free Tools API: the tables behind postboost.co/tools/social-media-video-specs: ratio, resolution, length, file size, formats and text safe zones for YouTube, Instagram, Facebook, TikTok, X, LinkedIn, Pinterest, Threads, Google Business Profile and Bluesky, with app and publishing API limits as separate rows and the sources of every row. No account needed.
API Changes
- New
getVideoSpecs(GET /tools/social-media-video-specs): optionalnetwork(e.g.tiktok; an unknown key is a 422 that lists the allowed ones); outputspecs(network,placement,ratio,resolution,length,max_size,formats,safe_zone,basis,sources, andlimitswith the row as numbers:min_seconds,max_seconds,warn_over_seconds,min_ratio,max_ratio,recommended_ratio,max_mb),last_verifiedandsources. Standard Free Tools limits, no token. - New
checkYoutubeThumbnail(POST /tools/youtube-thumbnail-size-checker): inputwidth,height,file_size_bytesandformat(MIME type), all required; outputokandchecks(key=ratio,width,file_sizeorformat;label;status=pass,failorcheck;detail), against YouTube's 16:9, 640 px minimum width and 2 MB rules. Standard Free Tools limits, no token.
MCP
- New
getVideoSpecsandcheckYoutubeThumbnailtools on/mcp/postboost, andget-video-specsandcheck-youtube-thumbnailon the public/mcp/toolsserver.
v1.39.0 — 2026-10-16
What's New
- Hook generator on the Free Tools API: the library behind postboost.co/tools/hook-generator: 83 hook templates for a post's first line, each with a style and the networks it suits, with your topic filled in. No account needed. With an API token, AI writes hooks for a specific topic, network and tone for 1 AI credit per call.
API Changes
- New
getHookTemplates(GET /tools/hook-generator/library): optionaltopic(fills the{topic}placeholder),category(question,contrarian,list,story,mistake,how-to,curiosity,social-proof),networkandsearch; outputhooks(text,template,category,networks) andtotal. Standard Free Tools limits, no token. - New
generateHooks(POST /tools/hook-generator): inputtopic, optionaltone,count(1 to 10, default 5),networkandworkspace; outputhooks(text,category),credits_spentandcached. Needs an API token and spends 1 AI credit of the workspace (0 for a cached answer). While AI is switched off it answers withcountlibrary templates and anoticeinstead of a 503, free of charge.
MCP
- New
getHookTemplatesandgenerateHookstools on/mcp/postboost, andget-hook-templatesandgenerate-hookson the public/mcp/toolsserver (generate-hooksonly with a token).
v1.38.0 — 2026-10-16
What's New
- The spec now describes webhook deliveries: a
WebhookEnvelopeschema (event,id,occurred_at,workspace_uuid,data) and an OpenAPI 3.1webhookssection with one entry per event, so you can type a webhook body from the spec instead of writing it by hand.
API Changes
- Breaking for SDK users (the HTTP API itself is unchanged):
Account.provideris a string: JavaAccount.getProvider()returns aStringand theAccount.ProviderEnumtype is gone in Java and TypeScript. The old enum threwIllegalArgumentException(Java) on networks it did not list.PostandCreatePost201Response:scheduled_at,published_atandcreated_atare strings (Y-m-d H:i:s, UTC) instead of date types such as Gotime.Timeor JavaOffsetDateTime, which could not parse the values the API returns. Parse them with that layout if you need a date type. In Go theNewPost(...)constructor signature changes with them.- About 80 fields the API can return as
nullare now nullable in the SDKs, includingMediaFolder.parentandAICredits.balance: PythonOptional, TypeScript| null, PHPopenAPINullables, and GoNullableXstruct fields (the getters and setters keep working; direct struct field access does not).
- The SDKs include the
WebhookEnvelopemodel. The per-eventwebhooksentries stay in the spec and the docs but are left out of SDK generation, because they describe requests you receive, not calls you make. The webhook subscription methods (listWebhookSubscriptions,createWebhookSubscription,deleteWebhookSubscription) are unchanged. - Every field the API can return as
nullnow uses the OpenAPI 3.1 formtype: [X, 'null'](87 fields that still used the 3.0nullablekeyword, which 3.1 validators and SDK generators ignore). Nullable enums listnullas a value. Account.provideris an open string with the known network keys in its description. The old enum listed 8 of the 17 keys, so strict SDK clients could fail to read an account list that holds, for example, a Bluesky, Threads or Google Business Profile account.Post:scheduled_at,published_atandcreated_atare documented in the format they have always had (Y-m-d H:i:s, UTC), not RFC 3339date-time.
MCP
uploadReportBrandingLogoanddownloadReportExportare no longer MCP tools: one needs a multipart file and the other returns a binary file. UsegetReportExport, which returns a signed download URL.- Tool arguments the spec marks as nullable keep their real type: list arguments such as
account_idsare arrays, numbers are numbers and booleans are booleans (some were offered as strings before).
v1.37.0 — 2026-10-16
API Changes
imageGenerate,imageEdit,imageVariations: the descriptions now state the real price, 1 image credit per image (429 image_credits_exhaustedwhen the monthly pool is empty), withcount × credit_weighttext credits only while the image credit pool is switched off.ImageGenerationResponseandImageVariationsResponsenow documentimage_credits_usedandimage_credits_remaining(nullable = no limit), which the endpoints already returned;credits_usedis text credits only.Media.idis documented as a string (a numeric id such as"42"): every media response has always returned it as a string, so typed SDK clients that expected an integer failed to read it.Media:created_atis documented in the format it has always had (Y-m-d H:i:s, UTC), andthumb_url,width,height,duration_ms,alt_textuse OpenAPI 3.1 null types so validators and SDKs accept the nulls the API returns.
v1.36.0 — 2026-10-16
What's New
- Link preview checker on the Free Tools API: the checker behind postboost.co/tools/link-preview-checker loads a public page once and returns its Open Graph and X card tags, the title, description and image X, LinkedIn, Facebook and chat apps would show, and what to fix (missing or small image, long title or description, a canonical or redirect to another page, noindex). No account needed.
API Changes
- New
checkLinkPreview(POST /tools/link-preview-checker): inputurl(http or https, up to 2,000 characters); outputfinal_url,status,redirects,content_type,tags,image(declared or measured size),previews(x,linkedin,facebook,chat) andwarnings. A private or non-http address, or a fourth redirect, returns 422; a page that does not load within 5 seconds returns 504. Results are cached for an hour. Limits: 20 calls per UTC day without a token, 200 with one.
MCP
- New
checkLinkPreviewtool on/mcp/postboostandcheck-link-previewon the public/mcp/toolsserver.
v1.35.0 — 2026-10-16
What's New
- QR code generator on the Free Tools API: the generator behind postboost.co/tools/qr-code-generator returns a QR code as SVG for a link or text, with optional UTM tags added exactly as the UTM builder adds them, and warnings for low-contrast or inverted colours. No account needed.
API Changes
- New
generateQrCode(POST /tools/qr-code-generator): inputdata(up to 1,000 characters), optionalutm(source,medium,campaign,term,content),error_correction(L,M,Q,H),size(128-2048 px),foregroundandbackground(#RRGGBB); outputdata(the encoded text),svgandwarnings. A text too long for a QR code at the chosen level returns 422.
MCP
- New
generateQrCodetool on/mcp/postboostandgenerate-qr-codeon the public/mcp/toolsserver.
v1.34.0 — 2026-10-16
What's New
- Threads counts emoji as UTF-8 bytes: Threads counts each emoji as its UTF-8 bytes toward the 500-character limit, so most emoji count as 4 and a family emoji as 18. Creating or updating a post now warns before Threads would reject it, the pre-publish checker flags it, and the free character counter, post checker and thread maker count Threads text the same way.
API Changes
createPost,updatePost: newwarnings[].codevaluethreads_too_long(a Threads account's post is over 500 characters as Threads counts them). The post is still saved.countCharacters,checkPost,splitThread: thethreadsrow counts each emoji as its UTF-8 bytes.
MCP
- The
countCharacters,checkPostandsplitThreadtools on/mcp/postboost, their/mcp/toolstwins and the connector's character counter and post checker count Threads emoji as UTF-8 bytes.
v1.33.0 — 2026-10-16
What's New
- Aspect ratio calculator on the Free Tools API: the maths behind postboost.co/tools/aspect-ratio-calculator: the simplified and decimal ratio of a width and height, or the missing side at a given ratio with the rounding stated, plus the social media image sizes with the same (or the nearest) ratio. No account needed.
API Changes
- New
calculateAspectRatio(POST /tools/aspect-ratio-calculator): inputwidth+height, orratio(e.g.16:9,1.91:1) with one of them; outputratio,decimal,width,height,rounding,orientationandmatches(presets fromgetImageSizes).
MCP
- New
calculateAspectRatiotool on/mcp/postboostandcalculate-aspect-ratioon the public/mcp/toolsserver.
v1.32.0 — 2026-10-16
What's New
- Social media post preview on the Free Tools API: the fold and image data behind postboost.co/tools/social-media-post-preview: for Instagram, X, LinkedIn and Facebook, the caption count against the limit, the text the feed shows before its "more" link and the image ratios the feed shows uncropped. Give the image size to learn the ratio each card shows and whether it crops. Fold positions and X's image range are approximate. No account needed.
API Changes
- New
previewPost(POST /tools/social-media-post-preview): inputtext, optionalinstagram_ratio(1:1,4:5or1.91:1) and optionalimage_width+image_height(pixels, both or neither); outputnetworks, one entry per card withkey,count,limit,over,preview,folded,min_ratioandmax_ratio, plusdisplay_ratioandcroppedwhen the image size is given.
MCP
- New
previewPosttool on/mcp/postboostandpreview-poston the public/mcp/toolsserver.
v1.31.0 — 2026-10-15
What's New
- LinkedIn and YouTube connections are checked daily too: the dead-token check now covers LinkedIn profiles and Pages (token introspection) and YouTube (Google tokeninfo), so a revoked connection shows "needs reconnect" before the next post fails.
API Changes
getAccountHealth: each account'sconnectionhas a newreconnect_reason(code,message,found_at) when the daily token check found its token dead, elsenull. Codes:meta_190_<subcode>,refresh_expired,linkedin_revoked,linkedin_expired,google_revoked.
MCP
getAccountHealthon/mcp/postboostandget-account-healthon the connector returnconnection.reconnect_reason.
v1.30.0 — 2026-10-15
What's New
- Image sizes, crop maths and best times to post on the Free Tools API: the data behind postboost.co/tools/social-media-image-sizes and /tools/best-time-to-post, with its sources and last-verified date, plus the resizer's crop calculation. No account needed.
API Changes
- New
getImageSizes(GET /tools/social-media-image-sizes?network=): every size row withnetwork_key,format_key, pixelwidth/heightwhen fixed, ratio, limits, basis and source, pluslast_verifiedandsources. - New
calculateCrop(POST /tools/social-media-image-sizes/crop): inputwidth,height, thennetwork+format(keys fromgetImageSizes) ortarget_width+target_height, andfit(coverorcontain); outputcrop,output,image,scaleandupscaled. - New
getBestTimesToPost(GET /tools/best-time-to-post?network=): one table per network (a column per study, a row per weekday),last_verified,sourcesand a pointer togetBestPostingTimesfor times from your own accounts. - The two GET operations send
Cache-Control: public, max-age=86400and anETag;If-None-Matchwith it returns304. An unknownnetworkorformatis a422that lists the allowed values. listFreeToolslists one entry per operation: a tool with several operations appears once peroperation_id, each with its owndocs_url.
MCP
- New
get-image-sizes,calculate-cropandget-best-times-to-posttools on the public/mcp/toolsserver and on/mcp/postboost.
v1.29.1 — 2026-10-15
What's New
- AI free tools match the web pages: the hashtag and caption generators accept the same input as the tools on postboost.co, and a generated caption always fits the chosen network's text limit (at most 2,200 characters; 280 for X).
API Changes
generateHashtags:topicis at most 200 characters (was 1,000);nicheis one of the page's niches (Fitness,Food and restaurants, ...; was free text).generateCaption:textis at most 500 characters (was 1,000); each of the threecaptionsfits the network's text limit, cut at the last sentence end that fits.- Both:
503now means AI tools are switched off; a call with a token is no longer refused when the guest AI budget is spent (your AI credits pay for it, as on the web pages).
MCP
generateHashtags/generate-hashtagsandgenerateCaption/generate-captionon/mcp/postboostand/mcp/toolstake the same limits.
v1.29.0 — 2026-10-15
What's New
- AI free tools on the API: the hashtag and caption generators from postboost.co/tools now run from code for any of Instagram, TikTok, LinkedIn, X, Threads and Facebook. They need an API token; a new generation spends 1 AI credit of your workspace, and repeating the same request is free (cached).
API Changes
- New
POST /tools/instagram-hashtag-generator(generateHashtags):topic, optionalniche,network,workspace; returnshashtags,credits_spent,cached. - New
POST /tools/instagram-caption-generator(generateCaption):text,tone,length,emoji,hashtags,network,workspace; returns threecaptions,credits_spent,cached. - Both:
401without a token (body hasregister_url),403for aworkspaceyou do not belong to or for a scoped API key without theaiability or bound to another workspace (code: insufficient_scope; a scoped key pays with its own workspace),429withcode: ai_credits_exhaustedandupgrade_urlwhen the workspace has no AI credits left,502when the AI provider fails (no credit spent),503when AI tools are off or out of budget. FreeToolErrorhas a new optionalcodefield.
MCP
- New tools
generateHashtagsandgenerateCaptionon/mcp/postboost, andgenerate-hashtagsandgenerate-captionon/mcp/tools(listed there only with a valid token). Scoped API keys get the sameinsufficient_scopechecks as on the API.
v1.28.0 — 2026-10-15
What's New
- YouTube description limit in bytes: YouTube accepts at most 5,000 bytes in a video description, and emoji or non-Latin letters take 2 to 4 bytes each. Creating or updating a post now warns before the upload would fail, and the free character counter counts the YouTube description in bytes.
API Changes
createPost,updatePost: two newwarnings[].codevalues:youtube_description_too_long(the description of a YouTube account's version is over 5,000 UTF-8 bytes) andyoutube_forbidden_characters(the YouTube title or description contains<or>). The post is still saved.countCharacters: theyoutuberow (video description) counts UTF-8 bytes;youtube_titlestill counts characters.
MCP
- The
countCharacterstool on/mcp/postboostandcount-characterson/mcp/toolsand the connector count the YouTube description in bytes.
v1.27.1 — 2026-10-15
What's New
- Free Tools API docs: one page per free tool with curl and 9 SDK examples, a "Free tools in 60 seconds" quickstart (no token, then with a token) and the public MCP server
https://postboost.co/mcp/toolsin the MCP guide. Free-tool calls work without a token in every SDK; to use a token, send it as a defaultAuthorizationheader (the quickstart shows how per SDK).
API Changes
listFreeTools:docs_urlnow links each tool's docs page (it wasnull).
v1.27.0 — 2026-10-15
What's New
- Social media post checker:
POST /app/api/tools/social-media-post-checker(checkPost) checks a post for each network before you publish: length as the network counts it, hashtag limit, media the network requires (Instagram, TikTok, Pinterest, YouTube), media count and type, video length, the see-more cut-off and links that are not clickable. Errors block publishing, warnings do not. No account needed. Same logic as the free tool at https://postboost.co/tools/social-media-post-checker.
API Changes
- New free tool operation
checkPostwithFreeToolCheckPostRequest/FreeToolCheckPostResponse; its input has an array (networks) and an object (media).
MCP
/mcp/postboost: new toolcheckPost(in-process)./mcp/tools(public, no token): new toolcheck-post.- Connector (
/mcp): new read-only toolcheck-post.
v1.26.2 — 2026-10-15
API Changes
- Free Tools API (
countCharacters,splitThread,cleanTextand the other POST tool operations): request bodies up to 128 KB are accepted (was 64 KB), so the documented 10,000-charactertextfits even when your JSON encoder escapes every emoji to a 12-byte😀pair (Pythonjson.dumps, PHPjson_encodedefaults). Larger bodies are still a413.
MCP
/mcp/tools: the same 128 KB body limit (was 64 KB).
v1.26.1 — 2026-10-15
API Changes
createConnectLink: the description's first line now carries the whole instruction (open the link, wait for the user, thenlist-accounts).- The API overview and the
blogToSocialcustom_instructionsexample no longer state a fixed platform count.
MCP
/mcp/postboost: thecreateConnectLinktool description is no longer cut off mid-sentence.- The connector (
POST /mcp) builds links and URLs from the configured site URL instead of the request's Host header.
v1.26.0 — 2026-10-15
What's New
- AI text cleaner:
POST /app/api/tools/ai-text-cleaner(cleanText) replaces em dashes, curly quotes, the ellipsis character, invisible characters and markdown markers in AI-written text, and flags common AI phrases with their offsets without changing them. No account needed. Same logic as the free tool at https://postboost.co/tools/ai-text-cleaner.
API Changes
- New free tool operation
cleanTextwithFreeToolCleanTextRequest/FreeToolCleanTextResponse.
MCP
/mcp/postboost: new toolcleanText(runs in-process, no HTTP sub-request)./mcp/tools(public, no token): new toolclean-text.
v1.25.0 — 2026-10-15
What's New
- Free tools over MCP, no account needed: a public MCP server at
https://postboost.co/mcp/toolslists every free tool with an API handler (character counter, X thread splitter, LinkedIn formatter, fancy text, UTM builder, engagement rate). Calls without a token have per-IP limits; a limit error includes aregister_url.
MCP
/mcp/tools(new, no auth): one tool per free tool, named after its operationId in kebab-case (count-characters,split-thread, ...). A bearer token is optional; an invalid one is a401. Bodies over 64 KB are a413./mcp/postboost: the free tool operations (countCharacters,splitThread, ...) now run in-process instead of calling the REST API over HTTP, with the same limits and usage counting.- Connector (
/mcp): new read-only toolcount-characters.
v1.24.1 — 2026-10-15
API Changes
countCharacters: without an API token,texttakes up to 5,000 characters (longer text is a422); with a token the limit stays 10,000. Counting all networks is now about twice as fast.
MCP
- The
count-characterstool description names the 5,000-character limit for calls without a token.
v1.24.0 — 2026-10-15
What's New
- Connect new accounts from an agent: an agent asks for a single-use link, the user opens it while logged in to PostBoost, confirms, and the usual sign-in with the network connects the account. The link expires after 15 minutes and signs no one in.
API Changes
createConnectLink: newPOST /{workspaceUuid}/accounts/connect-links(bodyprovider), returns201withurl,expires_atandprovider;422for Telegram, Discord and Slack (useconnectChannel) and for Mastodon, Pixelfed and Bluesky (connected in the app). Workspace admins only, 10 links per minute.
MCP
- New
create-connect-linktool on the connector (/mcp) andcreateConnectLinkon the advanced server.
v1.23.0 — 2026-10-14
What's New
- Free Tools API limits: calls without a token get 30 per minute and 500 per day per IP address; API tokens get 300 per minute, and Free-plan users 1,000 calls per day (paid plans have no daily cap).
API Changes
- Every Free Tools operation (
listFreeTools,countCharacters,splitThread,formatLinkedInPost,generateFancyText,buildUtmUrl,calculateEngagementRate): responses carryX-RateLimit-LimitandX-RateLimit-Remaining;429addsRetry-Afterand the body fieldsretry_after,register_urlorupgrade_url.
v1.22.0 — 2026-10-14
What's New
- Free Tools API: the free tools at postboost.co/tools are now API calls under
/tools: character counter, thread maker, LinkedIn formatter, fancy text, UTM builder and engagement rate. No account needed: call them without a token, or with any API token (no workspace, plan orapicapability). Same answers as the web tools. Calls are limited to 30 per minute per IP for now, with or without a token.
API Changes
- New tag
Free Tools, generated from the tool handlers byphp artisan tools:spec:listFreeTools(GET /tools),countCharacters,splitThread,formatLinkedInPost,generateFancyText,buildUtmUrlandcalculateEngagementRate(POST /tools/{slug}), each markedx-free-tool: true, withFreeTool*Request/FreeTool*Responseschemas and examples. - These operations accept requests without a token (
security: []); a token is optional, and an invalid token is401. Bodies over 64 KB are413, invalid input is422(countCharactersandsplitThreadtake up to 10,000 characters), too many requests are429.
MCP
- The advanced server (
/mcp/postboost) gains one tool per new operation.
v1.21.0 — 2026-10-14
What's New
- Failed-post fixer agent: a new agent type,
failed_post_fixer, looks at posts that failed on an account in the lastlookback_hoursand proposes the next step:reconnect_accountwhen the account must be reconnected, otherwiseretry_account, with the caption cut to the network limit (counted the way the network counts) when the text is over it, found by PostBoost's pre-publish check or the network's error. One open proposal per post and account: a newer one replaces the older (expired). No AI, no credits; every retry waits for a person's approval.
API Changes
WorkspaceAgent.typeandWorkspaceAgentInput.type: new valuefailed_post_fixer.WorkspaceAgentSettings: newlookback_hours(1 to 72, default 24).AgentProposal.kind: new valuesretry_account(payloaderrorand, for a shortened caption,source_account_id,item_index,before,after) andreconnect_account(payloaderror,reconnect_url).approveAgentProposal:retry_accountsaves the shortened caption on that account's version and publishes the account again; it becomesstalewhen the account is no longer failed, the post is publishing or the plan does not allow scheduling.reconnect_accountonly records the decision.
MCP
- The advanced server's
create-agentandupdate-agentacceptfailed_post_fixerandlookback_hours. The connector toolslist-agent-proposalsandapprove-agent-proposaldescribe the two new kinds.
v1.20.0 — 2026-10-14
What's New
- Warnings on post create and update: a successful
createPostorupdatePostcan now say when something will not behave as you expect, without failing the call: awarningsarray of{code, account_id, message}. The key is absent when there is nothing to report, so existing clients see no change. See Guardrails → Warnings.
API Changes
- New schemas
PostWarningandPostWarnings.createPost201andupdatePost200may includewarnings.updatePost200now documents its own body (successpluswarnings). - Codes:
ai_media_without_disclosure(AI-generated media withai_generated: false, so no AI label) andmeta_first_comment_unavailable(a Facebook Page or Instagram first comment while Meta reviews our access).
v1.19.0 — 2026-10-14
What's New
- Long repurpose runs no longer time out:
repurposeContent(POST /{workspaceUuid}/ai/repurpose) queues the run and waits up to 20 seconds. A run that finishes in time answers200with the same body as before. A slower run answers202with arun_idandstatus_urlinstead of a gateway error. Poll the newgetRepurposeRununtil the status isok,partialorfailed.
API Changes
repurposeContent: new optional body fieldasync(boolean, defaultfalse) to get the202right away; new202(RepurposeRunAccepted) and500(the run failed while the call waited, with itsrun_id) responses. Validation, account and credit errors still answer422/429before anything is queued.- New
getRepurposeRun(GET /{workspaceUuid}/ai/repurpose/runs/{runId}, tag AI, 60 calls per minute):status,error,post_uuid,credits_usedand, for one hour after a successful run,result(the200databody). A run still queued or running after 10 minutes reportsfailed.
MCP
- The MCP connector's
repurpose-contenttool tells you to call the new read-onlyget-repurpose-runtool with therun_idwhen a run takes longer than the wait. The advanced server gainsget-repurpose-runfrom the spec.
v1.18.0 — 2026-10-14
What's New
- RSS feeds can wait for approval:
mode: needs_approvaloncreateRssFeed/updateRssFeedgives each new item's post the next free queue slot with status "needs approval"; nothing publishes until someone approves it. See Automations.
API Changes
modeon RSS feeds (createRssFeed,updateRssFeed,RssFeed) acceptsneeds_approval. With a scoped API key it needswrite, likedraft.
MCP
- Connector
add-rss-feedlistsneeds_approvalin itsmodeenum.
v1.17.3 — 2026-10-14
What's New
- Free plan daily caps: Free workspaces get half the per-account daily caps (rounded down, at least 1), for example 12 Instagram posts per UTC day instead of 25. Paid plans are unchanged. See Guardrails.
API Changes
- No schema changes.
account_daily_cap_reachederrors anddaily_cap.limitinGET /{workspaceUuid}/account-healthandvalidatePostshow the reduced cap.
MCP
- The post tools and the Claude connector refuse scheduling past the reduced cap the same way.
v1.17.2 — 2026-10-14
What's New
- Clear errors for malformed schedule input:
schedulePostandapprovePostanswer 422 with validation errors instead of 500 for a malformeddate,time,timezoneoraccounts_schedule.
API Changes
- No schema changes. Both operations already documented the 422 response.
MCP
schedulePostandapprovePost(and the connector'sschedule-post) return the validation error for malformed schedule input instead of an internal error.
MCP connector — 2026-10-14
No API or spec change; the SDKs are unchanged.
MCP
- New connector tool
retry-failed-post: publishes a post again to one account whose publishing failed (the API'sretryPostAccount). Takes the account idget-postshows, or its uuid. - New connector tool
get-ai-credits: theGET /{workspaceUuid}/usage/aipayload, so an assistant can check credits beforerepurpose-content. create-posttakes an optionalidempotency_key: a retry with the same key and arguments within 24 hours returns the first result and creates no second post, like the API'sIdempotency-Keyheader.
v1.17.1 — 2026-10-14
What's New
- Queue caps on the right day:
addPostToQueueand thequeueflag oncreatePost,updatePostandvalidatePostnow check the daily cap on the UTC day of the queue slot the post will get (the earliest next free slot of its accounts' posting schedules), not today. A post queued after today's last slot is no longer refused because today is full. See Guardrails.
API Changes
- No schema changes. The
addPostToQueuedescription now says which day the cap is checked on.
MCP
add-post-to-queuechecks the cap on the queue slot's day, as above.update-postchecks the versions the post holds after the update: the saved per-account versions plus the ones you send. A content-only update no longer reports a duplicate for an account that keeps its own version.schedule-postandadd-post-to-queueanswer a non-stringuuidwith the validation error instead of an internal error.- Since v1.16.0,
update-poston a scheduled post checks it at its scheduled time. Changing its content or accounts is refused when an account needs reconnecting (account_unauthorized) or the day's cap is full. Drafts only get the duplicate check.
v1.16.0 — 2026-10-13
What's New
- Guardrails on schedule and queue:
schedulePost(POST /{workspaceUuid}/posts/schedule/{postUuid}) andaddPostToQueue(POST /{workspaceUuid}/posts/add-to-queue/{postUuid}) now run the same post guardrails ascreatePost/updatePoston the saved post. Previously, a draft followed by a schedule call skipped them. Schedule checks at the requested or saved publish time. Queue checks as publishing today (UTC). See Guardrails.
API Changes
schedulePostandaddPostToQueueadd409(PostConflict, duplicate content; override withX-Allow-Duplicate: true) and429(DailyCapReached, daily cap or X monthly allowance, e.g.x_monthly_cap_reached). Their422is nowPostUnprocessable(the account cannot publish, plus the existing validation errors).- Scheduling a post over the X monthly cap now returns
429 x_monthly_cap_reachedfrom the guardrail, where it used to return the engine's422quota response.
MCP
- The MCP connector's
create-post,update-post,schedule-postandadd-post-to-queuetools enforce the same guardrails (duplicate guard withallow_duplicate, daily caps, account health, X monthly allowance) and return a refusal as a tool error carrying the code.
v1.15.0 — 2026-10-12
What's New
- Webhook envelope: every delivery now carries a delivery
id(repeated on retries, so you can de-duplicate),occurred_atandworkspace_uuidnext toeventanddata. See Webhooks. - Platform post IDs:
Account.provider_post_id(the network's own ID of the published post) is returned wherever an account is embedded in a post, including webhook payloads. - Content Credentials on every upload: a JPEG that carries C2PA Content Credentials and needs no resize is now stored byte for byte on
uploadMediaand the dashboard too, not only onuploadMediaBase64. See AI disclosure. - PDFs on more upload paths: the chunked upload (
initiateChunkedUpload) accepts PDFs up to 100 MB, and the remote-URL import (initiateRemoteUpload) accepts a PDF under 10 MB. See Media uploads.
API Changes
Accountgainsprovider_post_id(nullable string).
MCP
- The MCP connector grew from 24 to 40 tools:
validate-post(dry run with guardrails),get-account-health(with X usage), brand voice get/update,upload-media(base64),list-automations,create-recycling-rule,add-rss-feed,create-report,repurpose-content, agents and their approval queue (list-agents,list-agent-proposals,approve-agent-proposal,reject-agent-proposal) and inbox drafts (list-inbox-drafts,create-inbox-draft; approving stays in the app). These run the REST API in-process, so scoped keys, guardrails and the activity log (client: mcp-connector) apply. - Scoped API keys are refused by the connector (
403 insufficient_scope); use OAuth, an unscoped dashboard token, or the advanced server.
v1.14.0 — 2026-10-12
What's New
- AI labels on Instagram and YouTube:
ai_generatednow sets Instagram's "AI info" label and YouTube's synthetic-media disclosure as well as TikTok's.X-AI-Disclosureisappliedfor all three. See AI disclosure. - LinkedIn document posts: upload a PDF (
uploadMedia,uploadMediaBase64) and attach it as the only media item of a LinkedIn post to publish it as a document carousel. See Media uploads.
API Changes
PostVersion.optionsdocumentsyoutube(PostOptionsYoutube, withcontains_synthetic_media) andinstagram/instagram_standalone(PostOptionsInstagram, withai_generated).createPost/updatePostreturn422when a PDF is attached next to other media or to non-LinkedIn accounts.
v1.13.0 — 2026-10-12
What's New
- AI usage endpoint:
GET /{workspaceUuid}/usage/aireturns text and image credits used and remaining in the current cycle. Image generation now draws from its own credit pool (429 image_credits_exhaustedwhen it runs out). - Learn brand voice from past posts:
POST /{workspaceUuid}/brand-voice/learnbuilds the brand-voice profile from the workspace's published posts. - Pagination (
page,per_page) on the template, hashtag-group and account-group lists; list totals respect account-limited API keys.
v1.12.0 — 2026-10-11
What's New
- Webhook subscriptions API: n8n, Zapier and Make triggers can register and remove their own webhooks. See Webhooks.
API Changes
New endpoints
| Method | Endpoint | Description |
|---|---|---|
GET POST | /{workspaceUuid}/webhooks/subscriptions | List webhooks, subscribe a callback URL |
DELETE | /{workspaceUuid}/webhooks/subscriptions/{subscriptionUuid} | Unsubscribe |
v1.11.0 — 2026-10-11
Includes spec 1.10.0, published the same day.
What's New
- Templates, hashtag groups, account groups, posting schedule and competitors are now in the API (24 operations). See Core Concepts.
- Inbox API (rolling out): agents read comments and draft replies; a person approves every reply before it is posted. Bluesky, Mastodon, LinkedIn Pages and Google Business Profile first. See Inbox.
API Changes
New endpoints
| Method | Endpoint | Description |
|---|---|---|
GET POST | /{workspaceUuid}/templates | List and create templates |
GET PUT DELETE | /{workspaceUuid}/templates/{templateId} | Read, update, delete a template |
GET POST | /{workspaceUuid}/hashtag-groups | List and create hashtag groups |
GET PUT DELETE | /{workspaceUuid}/hashtag-groups/{hashtagGroupId} | Read, update, delete a hashtag group |
GET POST | /{workspaceUuid}/account-groups | List and create account groups |
GET PUT DELETE | /{workspaceUuid}/account-groups/{accountGroupUuid} | Read, update, delete an account group |
GET PUT | /{workspaceUuid}/posting-schedule | Read and set queue times |
DELETE | /{workspaceUuid}/posting-schedule/{accountId} | Reset an account to the workspace schedule |
GET | /{workspaceUuid}/posting-schedule/recommended | Recommended posting times |
GET | /{workspaceUuid}/queue/slots | Upcoming queue slots |
GET POST | /{workspaceUuid}/competitors | List and track Instagram competitors |
GET DELETE | /{workspaceUuid}/competitors/{competitorId} | Competitor detail, stop tracking |
GET GET PATCH | /{workspaceUuid}/inbox/conversations[/{conversationId}] | Inbox conversations |
POST | /{workspaceUuid}/inbox/conversations/{conversationId}/drafts | Draft a reply |
GET PUT DELETE | /{workspaceUuid}/inbox/drafts[/{draftId}] | Reply drafts |
POST | /{workspaceUuid}/inbox/drafts/{draftId}/approve, /reject | Review a draft (publish ability) |
v1.9.0 — 2026-10-11
What's New
- Idempotent requests. Send
Idempotency-Keywith anyPOST; a retry with the same key returns the original response (Idempotent-Replayed: true) and creates nothing. - Agent guardrails. Create and update requests from the API are refused when they duplicate a post from the last 24 hours (
409 duplicate_post), exceed an account's daily post cap (429 account_daily_cap_reached), or schedule to an account that must be reconnected (422 account_unauthorized). See Agent Guardrails. - Readable platform errors. A failed account's
errorsnow starts with a readable line such as"Facebook: (#200) Permissions error (code 200)", followed by{platform, code, message, raw}with the network's original response. - Webhooks: deliveries carry
X-PostBoost-Workspace, and the webhook docs now describe the real events, payload, signature and retry schedule.
API Changes
New endpoints
| Method | Endpoint | Description |
|---|---|---|
POST | /app/api/{workspaceUuid}/posts/validate | Dry run of create-post: validation, network requirements, guardrails |
GET | /app/api/{workspaceUuid}/account-health | Authorized / token / daily-cap usage per account |
GET | /app/api/{workspaceUuid}/activity | Log of API write requests and their outcomes |
Changed
POST /postsandPUT /posts/{postUuid}can return409,429and new422codes (see above);allow_duplicateadded to the post body.- Breaking for raw error parsing: a raw network error in an account's
errorsmoved fromerrors.error.messagetoerrors[1].raw.error.message;errors[0]is the readable line. - Account objects inside posts document
external_urlanderrors.
MCP
- New curated MCP connector at
https://postboost.co/mcp: 24 workflow tools with titles and read-only / destructive / idempotent / open-world annotations, signed in with OAuth 2.1 (PKCE, dynamic client registration) from Claude.ai, ChatGPT, Claude Code, Cursor and VS Code. Dashboard access tokens still work for headless use. - The spec-generated server at
/mcp/postboostis now the advanced option (one tool per API operation) and gainedvalidatePost,getAccountHealthandlistApiActivityfrom API 1.9.0.
Docs
- New agent client guides for Claude Code, Cursor, Codex, Gemini CLI, OpenClaw and n8n.
- New network permissions status page.
- Fixed the Claude Code (
claude mcp add/ project.mcp.json), Cursor and VS Code configs on the MCP server page. - Machine-readable pricing and llms.txt.
v1.8.0 — 2026-10-11
What's New
- Major platform upgrade: new scheduling, analytics and media engine underneath the API.
- Analytics over the API: a cross-platform workspace summary, per-account analytics, a posting-times heatmap, best-time recommendations, and per-post analytics.
- Media folders: organize the media library in nested folders, and file uploads straight into a folder.
- Mention book: store people and pages once and reference them in post bodies with
{{mention:<reference>}}. Each mention resolves to the right handle on each network when the post is published. - Retry publishing to a single failed account without re-sending the post to accounts that already published.
- Per-account scheduling: give each account its own departure time with
accounts_schedule. - Post dates and times are now read in the request's timezone.
date,timeandaccounts_scheduleuse thetimezoneyou send, and fall back to the workspace timezone.PUT /posts/{postUuid}used to ignoretimezoneand now honours it. - A second MCP endpoint is available at
/app/mcp(30 tools), next to the existing/mcp/postboost. - The Engagement inbox that ships with this release is not enabled yet.
API Changes
New endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /app/api/workspaces | List the workspaces the authenticated user belongs to, with their role in each |
GET | /app/api/{workspaceUuid}/analytics | Cross-platform analytics summary (period or date_from/date_to) |
GET | /app/api/{workspaceUuid}/analytics/accounts/{accountUuid} | Analytics for one account (type, page, per_page, sort_by, sort_dir) |
GET | /app/api/{workspaceUuid}/analytics/posting-times | Engagement heatmap by weekday and hour (accounts[], timezone) |
GET | /app/api/{workspaceUuid}/analytics/best-times | Next recommended posting time per account (accounts[], from, timezone) |
GET | /app/api/{workspaceUuid}/posts/{postUuid}/analytics | Engagement metrics for a published post |
POST | /app/api/{workspaceUuid}/posts/retry/{postUuid}/{accountUuid} | Retry publishing to one failed account |
GET | /app/api/{workspaceUuid}/media/folders | List the media folder tree |
POST | /app/api/{workspaceUuid}/media/folders | Create a media folder |
PUT | /app/api/{workspaceUuid}/media/folders/{folderUuid} | Rename or move a media folder |
DELETE | /app/api/{workspaceUuid}/media/folders/{folderUuid} | Delete a media folder (optionally with its media) |
GET | /app/api/{workspaceUuid}/mentions | List the mention book (paginated, q search) |
POST | /app/api/{workspaceUuid}/mentions | Create a mention |
GET | /app/api/{workspaceUuid}/mentions/{mentionId} | Get a mention |
PUT | /app/api/{workspaceUuid}/mentions/{mentionId} | Update a mention |
DELETE | /app/api/{workspaceUuid}/mentions/{mentionId} | Delete a mention |
GET | /app/api/panel/workspaces/{workspaceUuid}/ai-credits | AI credit availability and balance for a workspace (admin) |
No endpoints were removed.
Deprecations
Workspace.hex_coloris deprecated: workspaces no longer store a colour (workspaces now useavatar), so panel workspace responses now return the constant4f46e5to keep existing clients working. Useavatar(nullable URL) instead. No breaking changes in this release.hex_colorin the workspace create/update body is no longer required. It is deprecated and ignored.- Every
/app/api/{workspaceUuid}/...endpoint now returns403when the workspace's plan does not include API access (plan capabilityapi). - Scheduling, approving, queueing, and creating or updating a scheduled post now check provider requirements up front (for example a network that requires media). Failures return
422instead of failing at publish time. POST /app/api/{workspaceUuid}/posts/schedule/{postUuid}withpostNow: truenow starts publishing within the request.DELETE /app/api/panel/workspaces/{workspaceUuid}/subscription/genericnow returns422when the workspace has no generic subscription. It used to return success.
New optional request fields
- Posts (
POST/PUT /posts):accounts_schedule[](account_id,date,time) andversions[].synced_with. POST /posts/schedule/{postUuid}andPOST /posts/approve/{postUuid}:date,time,timezone,accounts_schedule[].POST /posts/add-to-queue/{postUuid}:timezone. Each account now gets its own queue slot.GET /accounts:keyword,group,providers[],unauthorizedfilters.GET /media:limit,folder(UUID orroot),mime_types[],type,keyword,usage,favorite,sort.POST /media,POST /media/remote/initiate,POST /media/chunked/{uploadUuid}/complete:folder.PUT /media/{mediaUuid}:nameandfolder.alt_textis no longer required.DELETE /media:items[]accepts media UUIDs as well as numeric IDs (up to 500).POST /panel/workspaces/{workspaceUuid}/subscription/cancel:immediately. Past-due subscriptions can now be cancelled too.
New response fields (additive)
- Account:
profile_url. When embedded in a post, it also haspublish_statusandpublished_parts. - Media:
is_processing,width,height,duration_ms,size,alt_text,folder. - Post:
publish_progress(total,published,failed), present only while publishing.statusis now documented with all of its values:draft,scheduled,published,failed,needs_approval,publishing. - Post version:
synced_with. - Panel user:
avatar. - Schedule/queue responses:
needs_approval.
Platform & Media
- Video uploads are converted in the background, so a fresh upload may return
is_processing: trueuntil conversion finishes. - Media can be filed in nested folders. Deleting a folder moves its contents up a level unless
delete_mediais set.
v1.7.0 — 2026-04-12
API Changes
- AI image endpoints (
/ai/image-generate,/ai/image-edit,/ai/image-variations) return the standardMediaschema instead ofGeneratedImageItem, so generated images can be attached to posts directly. SDKs regenerated.
v1.6.0 — 2026-04-11
New API Endpoints
AI — Image Generation & Editing
| Method | Endpoint | Description |
|---|---|---|
POST | /{workspaceUuid}/ai/image-prompt | Build an optimized image generation prompt from a social media caption and platform. Use this to preview the prompt before calling image-generate. Costs 1 AI credit per call. |
POST | /{workspaceUuid}/ai/image-generate | Generate one or more social media images from a caption (standard mode) or a raw prompt (developer mode). Images are saved directly to the workspace media library. Credits: count × credit_weight (default 5 per image). |
POST | /{workspaceUuid}/ai/image-edit | Edit an existing workspace media image using a text prompt and optional mask. Results are saved to the media library. Credits: count × credit_weight. |
POST | /{workspaceUuid}/ai/image-variations | Generate one or more variations of an existing workspace media image. Results are saved to the media library. Credits: count × credit_weight. |
POST | /{workspaceUuid}/ai/image-alt-text | Analyze an existing workspace media image and generate accessible alt text. The alt text is saved back to the media record. Costs 1 AI credit per call. |
No breaking API changes.
v1.5.0 — 2026-04-04
New API Endpoint
AI
| Method | Endpoint | Description |
|---|---|---|
POST | /{workspaceUuid}/ai/blog-to-social | Generate platform-specific social media captions from a blog post URL or title and excerpt. Supports tone, hashtags, CTA, language, and optional draft post creation with image import. Consumes one AI credit per platform. |
No breaking API changes.
v1.4.0 — 2026-03-23
First SDK releases: Python, Node, PHP, Go, Ruby, C#, Rust, Java and the CLI were published as 1.0.0 to 1.4.0 on this day.
Platform Improvements
- Added Mastodon service management endpoints
- Facebook API updated to v25.0
- Improved HEIC and HEIF image upload support
- Post status is now set to
DRAFTwhen moved to trash
Media
- Chunked upload support for large files —
POST /{workspaceUuid}/media/chunked/initiate - Remote media download from URL —
POST /{workspaceUuid}/media/remote/initiate - Compatible with more video formats (MP4, MOV, AVI, WebM)
- Additional image format support
- Resolved infinite loading issue in Media Library
No breaking API changes.
v1.1.0 — 2025-12-29
New API Endpoints
Workspaces (admin token required)
| Method | Endpoint | Description |
|---|---|---|
GET | /panel/workspaces | List all workspaces |
POST | /panel/workspaces | Create workspace |
GET | /panel/workspaces/{uuid} | Get workspace |
PUT | /panel/workspaces/{uuid} | Update workspace |
DELETE | /panel/workspaces/{uuid} | Delete workspace |
DELETE | /panel/workspaces | Bulk delete workspaces |
POST | /panel/workspaces/{uuid}/users | Add user to workspace |
PUT | /panel/workspaces/{uuid}/users | Update user role |
DELETE | /panel/workspaces/{uuid}/users | Remove user from workspace |
Subscriptions (admin token required)
| Method | Endpoint | Description |
|---|---|---|
GET | /panel/workspaces/{uuid}/subscription | Get subscription |
POST | /panel/workspaces/{uuid}/subscription | Create subscription |
PUT | /panel/workspaces/{uuid}/subscription | Update subscription |
DELETE | /panel/workspaces/{uuid}/subscription | Delete subscription |
POST | /panel/workspaces/{uuid}/subscription/new | Checkout new subscription |
PUT | /panel/workspaces/{uuid}/subscription/change-plan | Change plan |
POST | /panel/workspaces/{uuid}/subscription/cancel | Cancel subscription |
POST | /panel/workspaces/{uuid}/subscription/resume | Resume subscription |
POST | /panel/workspaces/{uuid}/subscription/generic | Add generic subscription |
DELETE | /panel/workspaces/{uuid}/subscription/generic | Remove generic subscription |
Users (admin token required)
| Method | Endpoint | Description |
|---|---|---|
GET | /panel/users | List users |
POST | /panel/users | Create user |
GET | /panel/users/{id} | Get user |
PUT | /panel/users/{id} | Update user |
DELETE | /panel/users/{id} | Delete user |
DELETE | /panel/users | Bulk delete users |
Receipts (admin token required)
| Method | Endpoint | Description |
|---|---|---|
GET | /panel/receipts | List receipts |
POST | /panel/receipts | Create receipt |
GET | /panel/receipts/{id} | Get receipt |
PUT | /panel/receipts/{id} | Update receipt |
DELETE | /panel/receipts/{id} | Delete receipt |
DELETE | /panel/receipts | Bulk delete receipts |
v1.0.0 — 2025-08-15
Initial Release
Workspace endpoints (workspace API token required)
| Method | Endpoint | Description |
|---|---|---|
GET | /{workspaceUuid}/accounts | List connected social accounts |
GET | /{workspaceUuid}/accounts/{id} | Get account |
GET | /{workspaceUuid}/posts | List posts |
POST | /{workspaceUuid}/posts | Create post |
GET | /{workspaceUuid}/posts/{uuid} | Get post |
PUT | /{workspaceUuid}/posts/{uuid} | Update post |
DELETE | /{workspaceUuid}/posts/{uuid} | Delete post |
DELETE | /{workspaceUuid}/posts | Bulk delete posts |
POST | /{workspaceUuid}/posts/schedule/{uuid} | Schedule post |
POST | /{workspaceUuid}/posts/add-to-queue/{uuid} | Add to queue |
POST | /{workspaceUuid}/posts/approve/{uuid} | Approve post |
GET | /{workspaceUuid}/media | List media |
POST | /{workspaceUuid}/media | Upload media |
GET | /{workspaceUuid}/media/{id} | Get media |
PUT | /{workspaceUuid}/media/{id} | Update media |
DELETE | /{workspaceUuid}/media | Delete media |
GET | /{workspaceUuid}/tags | List tags |
POST | /{workspaceUuid}/tags | Create tag |
GET | /{workspaceUuid}/tags/{id} | Get tag |
PUT | /{workspaceUuid}/tags/{id} | Update tag |
DELETE | /{workspaceUuid}/tags/{id} | Delete tag |