API & MCP changelog

Every change to Pamba's REST API and MCP tools, newest first. Breaking changes say what to change on your side.

MCP server https://api.pamba.app/mcp · API docs · MCP tool reference

ChangedAgent & MCP

The MCP product map is read on demand

The MCP server's connection instructions no longer carry the product map; the new read_product_map tool and the pamba://product-map resource return it, so the connection carries far less text up front.

The instructions of the MCP server's initialize result now hold the transport rules and the connected workspace, and tell the model to read the product map before its first task, in under 16,000 characters. The product map, what each part of Pamba does and which tools drive it, is returned by the new read_product_map tool in pages of at most 40,000 characters (call it without page for page 1, which says how many pages there are), which is listed on every connection whatever its toolsets or readonly setting, and by the new resource pamba://product-map. A client that copies a server's instructions into each of its tool descriptions now carries a few kilobytes per tool instead of the whole map. A client needs no change: the instructions tell its model to read the map's pages before its first task.

NewComments

A comments inbox with what's new and what still needs a reply

The Comments page has an inbox, every comment and reply on all your accounts' videos in one list, newest first, with a dot on what arrived since you last looked and a filter for what still needs a reply, and the API and agents can read it too.

Finding the comments to answer used to mean opening each video and scanning it. The Comments page's new inbox tab lists every comment and reply from other people across all your TikTok and Instagram accounts in one place, by their newest activity, so a new reply under an old comment comes to the top.

  • •A dot on what's new: comments and replies that arrived since you last opened the inbox are marked, and the tab counts them. Opening the inbox clears them the next time, and marking them all seen clears them at once. Each person in the workspace has their own.
  • •A filter for the ones that need a reply shows only the comments none of your accounts has answered yet. A reply you sent, queued or scheduled counts as an answer, so two people never answer the same comment.
  • •Reply, like, pin and delete from the inbox as from a video, and the filters for platform, account, questions and search work there too.

For the API and agents, GET /comments and the list_comments tool take sort=latest (the inbox's order), needs_reply=true, since (only what Pamba found after a time) and new_only=true (only what's new since you last marked the inbox seen). On those reads each thread carries needs_reply and latest_activity_at, each comment found_at and is_new, and the page an inbox block with seen_through, new_count and found_through. POST /comments/inbox/seen and the new mark_comments_seen tool mark it seen, the same mark the app's dots use. An agent can now answer "which comments still need a reply?" in one call.

NewAccounts· Updated Nov 15

Give a Facebook account its own name at signup

A Facebook add-on's account can now sign up under a name of its own instead of its Instagram account's, so an Instagram account named like a brand can have a Facebook account with a person's name, and with a gender you choose.

Facebook takes only a person's first and last name, and a Facebook add-on's account used to sign up under its Instagram account's name. Two ways now give it a name of its own before it is made:

  • •PUT /devices/accounts/seat-usernames takes facebook_first_name and facebook_last_name on an Instagram seat's entry (a first and a last name, at least two words between them, at most 64 characters together, letters, spaces, hyphens, apostrophes and periods only), and set_account_username takes the same two parameters. A name Facebook would not take, or one sent for a TikTok seat, refuses that entry.
  • •PUT /devices/instagram/accounts/{username}/facebook-name with { "first_name": "...", "last_name": "..." } sets it for an Instagram account that already exists, and the new set_facebook_signup_name tool does the same. It answers 200 { instagram_username, facebook_signup_name, facebook_signup_gender }, facebook_signup_name being the name the Facebook account will sign up under; both names left out clear the one set here. It is refused with 409 once the Facebook account exists (has_facebook: change that one's name with POST /devices/accounts/profile-edits, platform facebook) or its signup has started, a failed one that reached the phone included (facebook_creation_started), for an account taken out of use (account_banned, account_suspended), and for an account that can't get Facebook (account_archived, not_pamba_created, not_on_phone).

The account's own name wins over its seat's. Without either, the Facebook account takes the Instagram account's name, as before.

Since 2026-11-15 a gender can go with the name: facebook_gender (male or female) on a seat's entry and on set_account_username, and gender on PUT /devices/instagram/accounts/{username}/facebook-name and set_facebook_signup_name, which answer it back as facebook_signup_gender. Each call to the route or tool replaces the name and the gender set there together, so a call with a gender and no names clears the name set there. Any other value is refused (400 facebook_gender_invalid, or that entry on the seat route). Without one, the Facebook account signs up with the gender its chosen Facebook name usually has, else the linked avatar's, else the gender of the name it signs up under, and female when none gives one.

NewAccounts

A late account moves your seats' next renewal back

When an account you bought arrives more than a day after you paid for it, your seats' next renewal moves back by the whole delay, so you get a full month with the account before you're charged again.

When an account you bought arrives more than 24 hours after its seat was paid for (after you saved its name, for an account Pamba creates under a name you pick; after its Instagram account arrived, for a Facebook add-on), the next renewal of the seats it was bought with moves later by the whole delay. An account that arrives within 24 hours changes nothing. Every seat billed with it renews on the new date, and any enhanced warming on those seats moves with it. Accounts you connect yourself are not counted.

GET /devices/accounts/seat-billing and the get_seat_billing tool now include renewal_moved while a moved renewal is still to come: from_epoch (the date it had), to_epoch (the new date), late_hours (the longest delay among the accounts that have arrived) and waiting_for_account (true while an account is still on its way, when the renewal is held a day at a time until it arrives). renews_at_epoch is your earliest coming renewal, which is the new date unless another card renews sooner. The renewal moves in its last day, so renewal_moved appears from then.

NewPosting & scheduling

Links to the Facebook copies of your Instagram reels

An Instagram reel shared to Facebook now carries the link to its Facebook post, once Pamba finds it on the linked Facebook profile.

Scheduled posts carry posted_facebook_video_url beside posted_tiktok_video_url and posted_instagram_video_url, on GET /devices/tiktok/posts/{postId}, GET /devices/tiktok/posts/scheduled and every other route that returns a scheduled post, and in the get_scheduled_post tool. On an Instagram reel shared to Facebook (share_to_facebook) it is the link to the Facebook copy, filled once Pamba's analytics read of the linked Facebook profile finds a post Facebook dates while the reel was posting, with the reel's caption. It is null until then, on every other post, for a reel shared to a Facebook Page, and when no copy is found within 60 days of the reel. The link is the permalink that GET /facebook/analytics/videos lists with the post's views, likes and comments.

ImprovedPosting & scheduling

Editing a post names a time it cannot read

Moving a scheduled post to a time written without its timezone is now refused with a message saying which formats it takes.

PUT /devices/tiktok/posts/{postId} answers 400 { error, error_code: "invalid_scheduled_at" } when a pending post's scheduled_at is neither a date (yyyy-MM-dd) nor a time with its offset (2026-12-25T14:00:00Z), the code POST /devices/instagram/avatar-projects/{avatarProjectId}/posts answers the same time with, and nothing of the edit is written. update_scheduled_post answers the same case with status invalid_scheduled_at and the message.

ImprovedAccounts

Buy up to 2,000 accounts in one order

One order of managed accounts can now hold up to 2,000 accounts, up from 1,000.

POST /devices/accounts/seat-checkout and purchase_account_seats now take up to 2,000 accounts in one order, across all platforms. An order above that is still refused, and a larger purchase is split into several orders.

ImprovedAgent & MCP

An MCP connection scoped to accounts can bring in its own pictures

An MCP connection limited to the accounts tools now also lists upload_editor_media and create_draft_project, so it can set a profile picture or attach a post's media from a file outside Pamba.

A connection to POST /mcp made with ?toolsets=accounts now lists upload_editor_media beside the account tools, and create_draft_project, which makes the empty project an upload is filed under when your workspace has none. Every media field on an account tool (update_account_profile's profile picture, a post's or a story's video or picture) takes only a link to a file stored on Pamba, and upload_editor_media is the tool that copies an outside file in and returns its link. Both are still documented under their own toolsets (editing and videos), which list them as before, and a readonly=true connection leaves both out, since they write.

ChangedAccounts

The high-demand notice on account seats now says up to 5 days

When you buy account seats during high demand, the notice now says new accounts may take up to 5 days to be created, where it said 3.

While high_demand is true on GET /devices/accounts/seat-options, new accounts may take up to 5 days to be created, and accounts you connect may wait up to 5 days for a phone to sign in on. The notice in the buy dialog and the high_demand_notice text on a checkout purchase_account_seats creates say 5 days where they said 3.

No field, value or rule changed: only the wait the notice names.

ImprovedCreating videos· Updated Nov 17

A clip Grok Imagine cannot generate is made with Gemini Omni

When Grok Imagine keeps failing to generate a clip for a reason other than the clip's content, Pamba now generates it with Gemini Omni instead of failing it. You are never charged more than the Grok Imagine price for such a clip, and the clip keeps Grok Imagine as its model for later takes.

A clip generation on Grok Imagine that still fails after its retries, for a reason other than its content, is generated with Gemini Omni. In get_project, the clip's generation_video_model then names Gemini Omni and video_model_fallback_from names Grok Imagine. For every model, a fallback that the clip's content did not cause now leaves the clip's video_model on the model you chose, so it can differ from generation_video_model; video_model still moves to the fallback model when the chosen model declined the clip's content. A clip Grok Imagine declined for its content fails as before, and a clip made by a fallback model is charged at the lower of the two models' prices.

Each clip now also says why a fallback model made its take: video_model_fallback_reason in get_project and on the clips of GET /projects/{projectId} and of a concept revert (POST /projects/{projectId}/creative-concepts/{conceptId}/select) is content_refused when the chosen model declined the clip's content, model_failing when it kept failing for another reason, and empty in get_project (null on the routes) when the take did not come from a fallback.

ImprovedWarming

Instagram warming sessions show every swipe

An Instagram warming session's page now shows a screenshot for every reel and every home feed scroll, each labeled with what happened on it, as a TikTok session's does.

GET /devices/tiktok/warming/sessions/{sessionId} and list_warming_sessions with session_id list an Instagram session's screenshots one per reel or home feed scroll, labeled as a TikTok session's are (kind, video_index, and for a reel that was read author, on_niche, liked and watch_seconds). kind has one new value, feed: a scroll of Instagram's home feed.

NewCreating videos

Replications recreate the original's motion graphics

When you replicate a video, the graphics laid over the original (animated lists, cards, titles, stickers, rain or confetti, and green-screen backgrounds behind the speaker) now come back as motion graphics, each change timed to the word it reacts to, and captions take a look matched to the original's. They are drawn once the video is generated. In the editor every graphic has its own track: change it in words, swap one of its pictures for your own (a green-screen background included), or run a review that checks them all and adds one you describe. Text hooks render exactly as the editor shows them.

A replication's editor state can now hold items of type motion (an animated graphic with its motion spec) and caption items with a caption_look, in every workspace; GET /workspaces reads motion_overlays: true.

POST /projects/{projectId}/motion-overlays/{itemId}/edit (edit_motion_overlay) changes one in words, and POST /projects/{projectId}/motion-overlays/review (review_motion_overlays) checks them all, taking optional feedback; a graphic the feedback asks for comes back as a new item. Both bill their AI cost in credits.

ImprovedAccounts

Seat options and billing show an agreed bundle price

Where Pamba agreed a price for TikTok, Instagram and Facebook accounts bought together, buying accounts quotes it, the billing page shows how many bundles are left, and the API reports both.

GET /devices/accounts/seat-options adds bundle_deal_prices_cents, the monthly price of each of your next bundles (one new TikTok, one new Instagram and one Facebook account in the same order) under a price you agreed with Pamba, and regular_bundle_price_cents, a bundle's price outside it. GET /devices/accounts/seat-billing adds bundle_deal, with bundles_total, bundles_remaining, remaining_tiers and workspaces_sharing, the number of your workspaces whose orders count against the same bundles. purchase_account_seats returns the same prices. Both are empty or absent for a workspace with no such agreement.

ImprovedPosting & scheduling

Longer captions, and a separate caption for Instagram

The schedule dialog no longer stops a video's description at 300 characters. A caption can now be as long as its platform allows, 4,000 characters on TikTok and 2,200 on Instagram. When a video goes to TikTok and Instagram together you can choose to write separate captions, so each platform gets its own wording and hashtags. A reel shared to Facebook carries the Instagram caption.

POST /projects/{projectId}/schedule takes a new optional instagram_caption (a form item in the multipart variant). With it the Instagram reel posts instagram_caption, its Facebook share carries the same text, and the TikTok post keeps caption; without it every leg posts caption, as before. It is checked against Instagram's rules (at most 2,200 characters and 5 hashtags), and sent without an Instagram destination it is refused with a 400.

schedule_post takes the same optional instagram_caption.

Read the guide
NewAgent & MCP

Important announcements reach your MCP client

When Pamba releases something important or a known problem slows the service, the assistant you connect to Pamba's MCP server now hears about it and can tell you, as the banner in the app does.

A tool result over MCP, on a connection made with a workspace API key or a sign-in token (a chat app's custom connector gets none), can carry a notice of the new kind announcement: a release or a known problem Pamba chose to tell MCP users about, in the first week after it starts, with announcement_id, announcement_kind (the kind GET /announcements lists it with), title, and when set body, link (a full address: a page in the Pamba app, opening in your workspace, or another https address) and link_label. A release comes once per user, whichever of your connections calls first, and not at all if you already clicked or dismissed it in the app. A known problem keeps coming with results while it lasts, in its first week, so a conversation that runs into it later still hears why, and its words can change under the same announcement_id when it is updated. At most one announcement rides a result. Most of what the banner shows never comes as a notice.

BreakingChangedComments

See which comments Instagram hid

The Comments page marks the comments Instagram hides from a post, which show only in the app's list of hidden comments, so they no longer look like comments Pamba can answer. Pamba no longer tries to reply to, like, pin or delete them, and comment automations skip them.

Instagram hides some comments from a post's comments, with its own filter or because the account hid them, and lists them only under its hidden comments in the app. Your Pamba phones look for a comment in the post's list, so they never found these and every reply, like, pin or delete of one failed. Such a comment, and every reply under it, now carries hidden_by_platform: true in GET /comments and list_comments, and the Comments page tags it as hidden on Instagram, with no reply, like, pin or delete. Replying to, liking, pinning or deleting it, or deleting a reply under it, is refused with a 409 whose error_code is comment_hidden (the tools return that status). One already queued before Pamba saw it hidden ends cancelled, never sent, with a status_detail saying Instagram hides the comment, and a comment automation skips the comment (skipped, detail comment_hidden). A comment shows hidden_by_platform once Pamba next reads its reel, and loses it once Instagram shows it again.

What to change: check hidden_by_platform before replying, liking, pinning or deleting, and treat comment_hidden as final for that comment while it carries the mark. Open it among the hidden comments in the Instagram app to reply to it, unhide it or delete it.

NewAccounts· Updated Nov 13

Post to a Facebook Page, and turn on professional mode

A Facebook account can now post as a Facebook Page with its own name, so a brand can post as itself. Set one up from the Facebook account's profile editor by choosing a Page name and a category. The reels of its Instagram account then post to the Page instead of the profile. Setting up a Page makes that Instagram account a creator account if it was personal, and the Facebook profile's name, username and picture can no longer be changed from Pamba. Once the account posts as its Page, the same profile editor changes the Page's picture and bio. A Page can't be renamed or removed in Pamba yet. You can also turn on professional mode for a Facebook profile from the same place. Since 2026-11-13 a Page name leaves out emoji, which Facebook doesn't allow in one.

POST /devices/accounts/profile-edits with platform facebook takes two new fields, each alone in its request: facebook_professional_mode: true, and facebook_page { name, category } (name at most 75 characters; category one of Digital creator, Blogger, Entrepreneur, Education, Health/beauty, Clothing (Brand), Community, Artist, Musician/band). update_account_profile takes facebook_professional_mode, facebook_page_name and facebook_page_category. Both answer 202 with a job_id.

They refuse with 400 facebook_professional_mode_invalid (false: professional mode is only turned on) and facebook_page_invalid (no name, a name too long or holding characters that cannot be typed, or since 2026-11-13 an emoji or a symbol such as ™, which Facebook doesn't allow in a Page name, or a category outside the list), and with 409 facebook_professional_mode_on (already on) and facebook_page_exists (the account has a Page, or one is being set up). While a Page is being set up, new_display_name, new_username and new_profile_picture_url on the account answer 409 facebook_profile_unlinked.

Once an account posts as a Page, new_profile_picture_url and new_bio on it (in update_account_profile too) change the Page's picture and bio, together or alone, as one job. new_bio is at most 255 characters on one line, and "" clears it; it refuses with 400 bio_too_long or bio_invalid. new_display_name and new_username on such an account answer 409 facebook_page_name_unsupported. new_bio on a Facebook account that posts as its profile stays refused with 400 unsupported_field.

GET /devices/accounts/profile-edits/{jobId} adds the kinds facebook_professional_mode and facebook_page, the requested fields and operations professional_mode and facebook_page, and the field facebook_page. A Page name Facebook does not accept fails the job with fb_page_name_refused. A change of a Page's picture or bio is the kind facebook_page_edit, with the requested fields and operations profile_picture and bio.

GET /devices/accounts/inventory adds professional_mode and facebook_page { name, category, bio, picture_url } on Facebook rows and cross_posts_to_facebook_page on Instagram rows; a pending edit adds new_facebook_page_name and new_facebook_page_category. list_accounts adds professional_mode, facebook_page_name, facebook_page_category, facebook_page_bio and facebook_page_picture_url on Facebook rows and cross_posts_to_facebook_page on Instagram rows.

NewAccounts

Archive posts instead of deleting them

You can now archive a posted TikTok or Instagram post to take it off the account's profile without deleting it, and unarchive it to bring it back in the same spot with its views, likes and comments. The archive action sits beside delete on a posted post, and archiving past posts from an account's menu, on your accounts page and on an avatar's accounts tab, takes every post the account has up at once. Posts that go out afterwards stay public. The phone works through about 20 posts at a time, with a pause between batches so the account's posting and warming carry on. TikTok archives a post by making it visible to only you, and Instagram moves it to its own archive. An archived post is unarchived before it can be deleted.

POST /devices/accounts/post-archives/all (archive_all_posts) archives every post an account has up now, or with action unarchive brings back every post Pamba archived, in one call: the way to hide an account's posts. POST /devices/accounts/post-archives (archive_posts) archives or unarchives up to 20 named posts, and DELETE /devices/accounts/post-archives/{jobId} (stop_post_archive) stops what is still waiting. GET /devices/accounts/posts and list_account_posts add archive and archived on each post and active_archives, max_per_archive_request, archivable_count and archived_count on the account. POST /devices/accounts/post-deletions refuses an archived post with 409 post_archived. The account activity feed adds items of kind post_archive with post_action and archive_posts.

BreakingChangedCreating videos

Content batches check each script's avatar project

A content batch is refused when a script names an avatar project that is not a live one in your workspace, and the answer names each such script, so no script is left that can never become a draft.

POST /content/batches/seed and the seed_content_batch tool now check every script's avatar_project_id before creating anything. One that is not a live (not deleted) avatar project of your workspace, such as an avatar's own id, refuses the whole batch with 400 { error } (the tool returns status invalid with the same message), naming each such script by its position (the first ten, then a count of the rest). Before, an avatar's own id failed with a server error, and a deleted avatar project's id created the batch with a script that never became a draft. An avatar_project_id that is not a well-formed id is still ignored, and the avatar is matched by avatar_name.

What to change: pass the avatar's project id (avatar_project_id from list_avatars, project_id from GET /avatars), not its id, or leave avatar_project_id out.

NewAccounts

Edit a Facebook account's profile

You can now edit your Facebook accounts' profiles from your accounts page and from an avatar's accounts tab, the same way as your other accounts, to change the account's name, its facebook.com username and its picture. The picture is shared with the Instagram account the Facebook account was made from, so a new picture on either one shows on both, and the profile editor of each says so. Facebook allows one name change every 60 days and only a person's name.

POST /devices/accounts/profile-edits and update_account_profile take platform facebook with new_display_name, new_username and new_profile_picture_url. They refuse with 400 a one-word name (facebook_name_needs_first_and_last), a name over 64 characters (facebook_name_too_long), a name holding characters that cannot be typed (facebook_name_invalid), a username that is not 5 to 50 letters, digits and periods (username_invalid), a name the profile already has, capitals aside, sent alone (facebook_name_unchanged) and an account whose Instagram account is gone (facebook_account_not_linked), and with 409 a name change within Facebook's 60 days (facebook_name_locked). A name Facebook refuses as a person's reads failed with fb_name_refused on the job.

GET /devices/accounts/inventory adds picture_synced, linked_instagram_profile_picture_url and name_locked_until on Facebook rows, and facebook_picture_follower on Instagram rows. list_accounts adds profile_username, picture_shared_with_instagram and name_locked_until on Facebook rows.

BreakingRemovedCreating videos

Premium voices are gone, and every voice is free

Paid premium voices are no longer offered. Every avatar picks from the same free voices, labeled by position, and an avatar that already has a premium voice keeps it.

Removed, each now a 404: POST /avatars/projects/{projectId}/premium-voice and POST /avatars/wizards/{wizardId}/voices. The MCP and agent tools generate_premium_voice and generate_avatar_voices are gone, and GET /usage/pricing and get_credit_pricing no longer return premium_voice_generation_credits.

Changed: video_model_based_voice_creation on POST /avatars/generations and on the POST /avatars/projects/raw form is ignored, so the avatar gets a free voice and is never charged for one. get_preset_voices returns each voice's label (Voice 1, Voice 2, Voice 3, by position) in place of name, and the wizard's voice_options in get_avatar_wizard and reroll_preset_voices carry the same label. None of the three returns a voice's accent any more: an avatar's accent comes from its own accent setting, never from the voice. A wizard that made a premium voice before the removal still lists it, first, in get_avatar_wizard and reroll_preset_voices, so select a voice by its id, never by its position.

What to change: stop calling the removed routes and tools, and read voices from GET /avatars/projects/{projectId}/preset-voices with POST /avatars/projects/{projectId}/preset-voices/select, or the wizard's voice_options with POST /avatars/wizards/{wizardId}/voices/select (get_preset_voices, apply_preset_voice and select_avatar_voice over MCP). Read label where you read name from get_preset_voices, and the avatar's accent (get_avatar, get_avatar_wizard) where you read a voice's.

Read the guide
ImprovedAccounts

Recreate an account whose phone takes no new accounts

When Pamba holds an account's phone back from new accounts, for example after another account on it was suspended, you can still recreate the account. The new account goes on another of your phones, or on a new one, and the old one stays where it is. A suspended or banned account with no free replacement is still replaced for you.

POST /devices/accounts/recreate and recreate_social_account no longer refuse an account in use with phone_on_hold: its new account is made on another of the workspace's phones, or on a new phone, and the replaced account stays signed in where it is. The 10-day cooldown still applies. phone_on_hold now means only that the account is suspended or banned with no replacement_offer, on a phone held back from new accounts, and it is replaced for you. GET /devices/accounts/inventory rows and GET /devices/accounts/recreation read the same way.

ImprovedAccounts

Replaced accounts stay with your archived accounts

An account you replaced with a new one, or that was archived and then signed out of its phone, now stays on your list of accounts with your other archived accounts, instead of leaving the list. Its videos and analytics were always kept; now the account itself is there to find too.

GET /devices/accounts/inventory and the list_accounts tool also list an archived account the workspace held (one of its seats named it, or it posted from it, and no other workspace did after) once it has left the workspace's phones, such as an account a recreation replaced: its status is archived, frozen is true, on_device is false and it carries no replacement_offer. Archived accounts are listed after every other account, and only the accounts that are not archived are places to post. A Facebook account linked to an archived Instagram account reads archived too, as it was already frozen with it. The enhanced warming list (GET /billing/enhanced-warming, get_enhanced_warming) shows an archived account only while it still has enhanced warming, since one can never be turned on.

NewCreating videos

Replicate videos with several characters

A skit, a drama or a cartoon with several people can now be replicated. Choose new characters on the create page to have every person designed for your video, or keep your avatar as the lead and the other people are designed around it.

Changed: selected_avatar_project_id on POST /projects/replications and avatar_project_id on the replicate_project tool are now optional. Leave them out and every person of the replica is designed for it in the reference's look; send them and the avatar plays the lead while every other person who speaks or recurs is designed for the video.

NewCreating videos

Sort your videos by most views

The Videos tab can now sort by most views, so your best-performing videos and slideshows come first and each card shows its views.

Sort the Videos tab by most views to see the videos and slideshows with the most views first. An item's views add up across its published TikTok and Instagram posts, so a video you posted to both ranks by its whole reach, and each card shows its total. Items with no views yet follow, newest first. Show only posted videos with it to find your top videos and download them.

For the API and the agent: GET /content/studio/review-queue and get_studio_overview take sort=views, and each item in a views-sorted read carries views, the views of its published posts (null in the API, and absent for the agent, when none has views yet).

ImprovedAccounts

A recreated account keeps its row

While an account is being recreated, its new account now shows as being created in the old account's row, on your list of accounts and on its avatar's accounts tab, and it takes that same row once it's ready. Accounts still being set up also show as soon as the list loads, without moving the rows below them.

GET /devices/accounts/inventory adds seat_views_last_7_days to each account: its own views plus those of the accounts its seat held before it and handed on within the last 7 days, which the default order ranks by, and slot_rank, its seat's place among your live seats, oldest first, which breaks a tie of views (a tie-break, not an identifier: it moves up when an older seat ends): every account that holds the seat in turn shares it, so a recreated account lands where the one it replaced stood. Each entry of recreations adds place, the order facts the replaced account's row had (status, health_flags, views_last_7_days, seat_views_last_7_days, slot_rank, position), where position, counted as the accounts' positions are, names the account the recreation stands just above. The accounts' own positions are unchanged.

Read the guide
BreakingChangedAccounts

Banned and suspended accounts take nothing more

When TikTok or Instagram bans one of your accounts, or Instagram suspends it or asks it for identity verification, its scheduled posts now fail with a message saying why, and Pamba refuses any new post, profile edit, comment or other change on it, so nothing waits on an account that can't post. Schedule those videos again on another account, or on the new account that replaces it.

Every request that would run or change anything on an account TikTok or Instagram banned (its BANNED health flag), or Instagram suspended or asks for identity verification (SUSPENDED or IDENTITY_VERIFICATION), is refused with a 409 whose error_code is account_banned or account_suspended, with a sentence naming the account in message (in error on a schedule's refusal). The tools return a status of the same name. Scheduling such an account answers the new code account_banned beside account_suspended, and an appeal of its TikTok issues is refused too. Its pending posts fail with the same error_code and error_message, and its queued work leaves the schedule with that code. A TikTok ban applies once the account shows as banned, and its work may wait a short while before that. Such an account's pending posts no longer carry awaiting_replacement: true.

What to change: treat account_banned and account_suspended as final for that account. Schedule its videos on another account, or on the new one POST /devices/accounts/recreate makes when the account carries replacement_offer. Recreating, unlinking and pausing the account, and cancelling its seat, still work.

NewAccounts

Replace a banned TikTok account for free

When TikTok bans one of your accounts after its first day, Pamba now shows it as banned in your accounts list, where you can create a new account in its place for free (one a month per account slot). Its scheduled posts fail with a message saying why, so you can schedule them again on another account or the new one.

GET /devices/accounts/inventory rows, GET /devices/accounts/recreation, list_accounts and get_account_recreation carry replacement_offer with the new reason banned on a TikTok account TikTok banned after its first day (it also carries the BANNED health flag). While a TikTok account carries that offer, POST /devices/accounts/recreate and recreate_social_account take it with platform tiktok (with no cooldown and without phone_on_hold); every other TikTok account is still refused with unsupported_platform.

NewAccounts

Facebook accounts for your Instagram accounts

You can now add a Facebook account to an Instagram account Pamba created for you, for $100 a month on top of its Instagram seat. Pamba creates the Facebook account from the Instagram one, with the same name and picture, and every reel the Instagram account posts goes to Facebook too. Add it from your accounts page, to an account you already have or to new Instagram accounts as you buy them. A switch on each Instagram account turns the cross-posting off, and you can keep a single reel off Facebook when you schedule it.

GET /devices/accounts/seat-options adds facebook_addon_price_cents, facebook_addon_offer (none or with_new_accounts), facebook_addon_accounts (the Instagram accounts you have that can take Facebook now) and facebook_addon_unusable_slots. POST /devices/accounts/seat-checkout and purchase_account_seats take facebook_for_instagram, a list of Instagram usernames you already have, and facebook_seats, how many of the order's new Instagram accounts get one (at most one each). A Facebook add-on never pairs: Instagram with Facebook is $200 a month.

GET /devices/accounts/inventory and list_accounts list a Facebook account as a row with platform facebook and linked_instagram_username, and add linked_facebook_username, facebook_addon_eligible, facebook_addon_refusal and facebook_addon_phone_group on Instagram rows. For now, accounts with the same facebook_addon_phone_group are a choice of one.

Reels follow the Instagram account's facebook_cross_post_enabled switch, on by default: PUT /devices/accounts/warming and set_account_facebook_cross_posting for one account, update_avatar_settings for every Instagram account of an avatar. share_to_facebook on a scheduled Instagram reel overrides it for one post: false keeps the reel off Facebook, and true asks for the share and is refused with 409 facebook_cross_post_off, no_linked_facebook_account or facebook_account_paused when it cannot happen. A reel's share is decided again when it posts.

PATCH /devices/facebook/accounts/{username}/status pauses and resumes a Facebook account; a paused one receives no cross-posts. Cancelling an Instagram seat cancels its Facebook add-on with it on the same date (facebook_addon_cancelled), and a Facebook add-on can be cancelled on its own with cancel_account_seat and platform facebook.

Learn more
NewCreating videos

See and change the accent your avatar speaks with

An avatar's accent now shows in its voice settings and on the create page, where it is read from your description, and you can change it in either place. The accent is what your videos are asked to speak in, whatever the voice, so changing the voice never changes it.

New: accent on PUT /avatars/projects/{projectId}/selected-avatar (up to 60 characters) sets the accent, and GET /avatars/wizards/{wizardId} returns the wizard avatar's avatar_accent. The agent and MCP tool update_avatar_settings takes accent, and get_avatar and get_avatar_wizard return it. Videos generated after the change use the new accent; finished ones keep theirs.

Read the guide
NewWorkspaces & API keys

Teach your videos how to say a word

Your workspace settings now have a pronunciations list for words your videos should say differently from how they are written, such as a brand name the voice gets wrong. New clips say each word the way you list it, while your scripts and captions keep the real spelling.

New: PUT /workspaces/{workspaceId}/pronunciations replaces the list with { pronunciations: [{ written, spoken }] } (at most 50 entries; a caller whose role is member gets 403), and GET /workspaces returns each workspace's pronunciations. The agent and MCP tool update_pronunciations adds, changes or removes entries, and list_workspaces returns the list. It applies to clips generated after the change.

Read the guide
ChangedPosting & scheduling

Reading a long schedule page by page

list_scheduled_posts now says when a window holds more posts than it returned, and lets you read the rest page by page, so a 90-day window no longer looks like it ends early.

list_scheduled_posts returns at most 200 posts per call. When the window holds more, truncated is now true (it used to stay false until 2,000), and the answer carries next_offset. Call again with the same window and the new optional offset parameter set to next_offset until truncated is false. Every answer also echoes the offset it started from.

NewWarming

Search terms written for an account's niche

When you give an account or an avatar a niche of its own, Pamba can now write its warming search terms for that niche, in place of the current ones; tick the box under the niche as you save it.

PUT /devices/accounts/warming takes generate_search_terms: true, which replaces the account's search terms with terms written for its own niche: the niche sent with it, or the one the account already has. PUT /avatars/projects/{projectId}/selected-avatar takes generate_warming_search_terms: true for every account the avatar links. Either is refused beside terms of your own, and with no niche of the account's or avatar's own; a generation that fails answers 503 and changes nothing. A generation counts as one AI assist, so once the day's assists are used it answers 429.

set_account_warming_niche takes generate_search_terms, which it also accepts alone to write terms for the niche the account already has, and returns the written terms as search_terms; update_avatar_settings takes generate_warming_search_terms and returns them as warming_search_terms. Both answer no_niche when there is no niche of the account's or avatar's own, and generation_failed when the terms could not be written.

Read the guide
NewSlideshows

One-slide slideshows post to Instagram

A slideshow with a single slide can now go to Instagram, where it posts as a single photo. Two or more slides still post as a carousel, and a reel made from the slides still needs at least two.

schedule_slideshow_post and POST /slideshows/{slideshowId}/schedule now take a one-slide slideshow with platform instagram or both. One slide goes out on Instagram as a single photo, carrying the slideshow's Instagram sound like a carousel does. as_reel=true still needs at least 2 slides and is refused for a one-slide slideshow.

ChangedPosting & scheduling

TikTok sounds that aren't available

When TikTok says a post's sound isn't available, the post now fails with that reason instead of a generic sound error, so you know to pick another sound before you retry.

New error_code on a failed TikTok post: sound_unavailable. Nothing was posted, and Pamba does not retry it: pick another sound with set_slideshow_sound or set_video_tiktok_sound first, or the retry fails the same way.

ImprovedComments

Instagram automations message the newest comments first

On Instagram, comment-to-DM automations now answer each post's newest comment first, your posts taking turns, so on a post that keeps getting comments the DMs go out while the comments are fresh and your other posts' DMs still get their turn. A DM whose comment can't be found no longer uses one of the account's 20 DMs that day.

On Instagram, queued messages go out each post's newest comment first, the posts taking turns (TikTok keeps the oldest comment first). On both platforms, a message that ends not_sent with detail comment_not_found or video_not_found no longer counts toward daily_dm_limit.

Read the guide
ImprovedComments

Instagram automations skip private profiles

On Instagram, a comment-to-DM automation no longer tries to message someone whose profile is private, since Instagram gives no way to message them from it. Their comment gets your fallback reply instead, spread out with the account's comments within a week, and they don't use one of the account's 20 DMs that day, so the day's DMs go to people who can get them.

On Instagram, a message to a commenter whose profile is private ends skipped with detail private_profile: no message is tried, it doesn't count toward daily_dm_limit, and the comment gets the automation's fallback reply (reply_detail stays null while it waits for room in the account's comments, and is expired if the comment turns 7 days old first). TikTok is unchanged.

Read the guide
NewWarming

Longer warming around each post

A new add-on, enhanced warming, gives each post of the TikTok and Instagram accounts you choose longer warming around it, billed per account per month with each account's seat. Your account's activity shows that warming before and after each post.

Turn it on for any account on a paid seat, in the account's menu on your accounts page or the gear beside its warming. It renews on the same day as your seats: an account added partway through the month is charged until then, and one turned off keeps it until the end of the month you paid for. Cancelling an account's seat turns it off too, so both end together, and your billing settings list it beside your seats.

New routes: GET /billing/enhanced-warming reads each account's add-on, POST /billing/enhanced-warming/checkout opens the page that turns it on for the accounts named, and POST /billing/enhanced-warming/remove turns it off for them at the end of the period. New tools: get_enhanced_warming, turn_on_enhanced_warming and turn_off_enhanced_warming. GET /devices/accounts/activity and get_account_activity add chain_stage (before_post or after_post) and chain_post_id to a warming session that ran around a post. POST /devices/accounts/seat/cancel and POST /devices/accounts/seat/reinstate also turn an account's enhanced warming off and back on with its seat.

BreakingChangedAccounts· Updated Nov 9

TikTok and Instagram pair pricing ends for new accounts on November 16

If you sign up for Pamba from now on, every TikTok or Instagram account costs $100 a month. If you joined before, the accounts you have, and any you add before Monday, November 16, 2026, keep the second account of each TikTok and Instagram pair at $50 a month for as long as you keep them. Every account added from November 16 costs $100 a month, including one you cancel and add again.

Changed: bundle_eligible on GET /devices/accounts/seat-options now says whether the seats you buy now pair. It is false for a workspace whose owner signed up after November 5, 2026, and from 08:00 UTC (midnight Pacific) on November 16, 2026 it is false for every workspace unless Pamba agreed a different price with you, even one whose existing pairs still bill at $50. Its unpaired_seats (and each card's) is then empty, and every seat bought from then bills price_cents. Seats bought before keep their pair price on GET /devices/accounts/seat-billing, GET /devices/accounts/inventory and the bill for as long as both seats of the pair bill.

Added: purchase_account_seats returns bundle_eligible with its options.

What to change: read the price of the seats you have from GET /devices/accounts/seat-billing or each account's seat_monthly_cents on GET /devices/accounts/inventory (get_seat_billing over MCP), never from bundle_eligible, which only prices a purchase.

ImprovedPosting & scheduling

Scheduled posts keep clear of new accounts being set up on the same phone

When a phone has a new account coming (a seat you bought or an account being recreated), the time its setup needs is booked on the phone's schedule from the start, so a post you schedule on that phone is placed around it and keeps the time you picked.

Changed: GET /devices/accounts/schedule (and get_account_schedule) lists a new account's setup booked on the phone as busy with kind task, at the time it is expected to reach the phone, and leaves it out of openings. An exact TikTok scheduled_at inside it is refused with the existing schedule_conflict, which names the next free time, and an exact Instagram one moves to the next free time that day; a date-only schedule picks a time around it.

NewWorkspaces & API keys

Referral partners see their program

If you are a Pamba referral partner, your settings show your referral link, the signups it brought, your commission and your payouts.

GET /referrals/me and the get_referral_program tool return your referral programs: the link, its signups (dates and seats only), eligible seats, commission by state and by month, and payouts. Anyone who is not a referral partner gets an empty programs list.

NewAccounts· Updated Nov 13

Replace a suspended Instagram account for free

When Instagram suspends one of your accounts, or asks it for identity verification, after its first day, you can create a new account in its place for free (one a month per account slot) from your accounts list. Since 2026-11-08 its scheduled posts fail with a message saying why, and nothing more runs on it.

GET /devices/accounts/inventory rows and GET /devices/accounts/recreation carry replacement_offer (reason: suspended or identity_verification, since_epoch) when an Instagram account can be replaced for free: POST /devices/accounts/recreate then takes it with no cooldown and without phone_on_hold. The new health flag IDENTITY_VERIFICATION marks an account Instagram asks for a video selfie (its incident's error_code is ig_identity_verification). POST /devices/accounts/recreate and recreate_social_account take posts_start_after_days (0 to 14) to start the moved posts at least that many days after the new account is ready, each moved by whole days so it keeps its time of day and spacing; GET /devices/accounts/recreation and get_account_recreation add scheduled_post_count. POST /devices/accounts/username-suggestions takes replacing ({ platform, username }), and suggest_account_usernames takes replacing_platform and replacing_username, to suggest usernames for the new account. awaiting_replacement (GET /devices/tiktok/posts/scheduled, GET /devices/tiktok/posts/{postId}, the project's scheduled_posts, GET /slideshows/{slideshowId}/scheduled-post, and the agent's scheduled-post tools) marks a pending post waiting for its account's replacement. Since 2026-11-08 a suspended or identity-checked account's pending posts fail with account_suspended instead, as the entry on banned and suspended accounts says. Since 2026-11-13 the new Instagram account is no longer always made on a different phone: it can be made on the same phone, in the old account's place.

NewWarming

A warming niche for each account

Accounts in one workspace can now warm in different niches. Every account follows your workspace niche until you give it, or its avatar, a niche of its own on its page.

PUT /devices/accounts/warming takes niche, the account's own, and use_workspace_niche: true, back to the workspace's niche_description; it and GET /devices/accounts/warming answer niche and niche_source (own or workspace). PUT /avatars/projects/{projectId}/selected-avatar takes warming_niche and use_workspace_niche for every account the avatar links, and GET /devices/tiktok/warming/config/avatar-projects/{avatarProjectId} answers niche and niche_source. The new GET /devices/accounts/warming-niches lists the accounts and avatars with a niche of their own. PATCH /workspaces/{workspaceId} takes own_niches with a new niche_description: keep, the default, leaves those on theirs, replace moves them onto the new one, and the answer counts them in own_niches_replaced.

New tools: set_account_warming_niche and list_warming_niches. update_avatar_settings takes warming_niche and use_workspace_niche, update_workspace_settings takes own_niches and names the accounts and avatars that kept their own in own_niches_kept, and get_account_warming_config and get_warming_config return niche and niche_source.

Read the guide
BreakingChangedAccounts· Updated Nov 5

Pamba replaces banned Instagram accounts, and those suspended on their first day

When Instagram suspends one of your accounts in its first day, or bans one, Pamba replaces it for you, and until then you can't recreate it yourself. An account suspended after its first day you can now replace yourself, for free.

POST /devices/accounts/recreate and the recreate_social_account tool refuse, with phone_on_hold, an Instagram account on a phone where Instagram suspended or banned an account, and GET /devices/accounts/recreation and get_account_recreation report the same refusal.

What to change: treat phone_on_hold on such an account as final unless it carries replacement_offer, and contact support for its replacement.

Since 2026-11-05 an Instagram account suspended, or asked for identity verification, after its first day carries replacement_offer, and POST /devices/accounts/recreate replaces it for free instead of answering phone_on_hold.

NewPosting & scheduling

TikTok stories, and videos on Instagram stories

Post a picture or a video to a TikTok account's story, seen by everyone, now or at a time you pick. Instagram stories take a video as well as a picture.

New routes: POST and GET /devices/tiktok/accounts/{username}/stories, for any TikTok account on your phones, linked to an avatar or not. A request takes image_url or video_url (exactly one) and an optional scheduled_at; a story has no link, song or highlight, and is seen by everyone. New tools: post_tiktok_story, list_tiktok_stories.

POST /devices/instagram/accounts/{username}/stories and post_instagram_story take video_url beside image_url, exactly one of the two: a Pamba video of at most 60 seconds (a rendered video, an uploaded one, or a media-library video). A video story plays its own sound, so it takes no instagram_audio_id or surprise_song. The story response carries video_url, and image_url is null for a video story.

New error_code values on a refused story request (400): invalid_media (both image_url and video_url, or neither) and invalid_video_url. invalid_song also answers a song sent with video_url.

BreakingChangedPosting & scheduling

Instagram reel drafts, and 10 drafts per account

only_create_draft now saves an Instagram reel as a draft in the app instead of sharing it, as it already did for TikTok posts, and one account gets at most 10 drafts.

only_create_draft: true on POST /projects/{projectId}/schedule now makes every leg a draft, the Instagram reel included: the phone prepares the reel as usual and saves it as a draft instead of sharing it. Before, only the TikTok leg was saved as a draft and the Instagram leg was shared. POST /devices/instagram/avatar-projects/{avatarProjectId}/posts and schedule_instagram_post take only_create_draft too, schedule_post now takes it for every platform it schedules, and PUT /devices/tiktok/posts/{postId} and update_scheduled_post turn it on or off for an Instagram post as well as a TikTok one.

A draft is never shared, so its post completes with nothing live and its project reads draft_created, or posted when another of its posts already went live. Pamba never publishes a draft later.

New error_code on a refused schedule or edit: instagram_draft_not_shareable (400). An Instagram draft takes no share_to_facebook: true and no trial_reel, and the automatic Facebook cross-post skips it.

Each draft takes room on the account's phone, so one TikTok or Instagram account gets at most 10 drafts in its life. A cancelled or failed draft is not counted, except an Instagram one whose outcome was lost. Past that, a draft is refused with the new code draft_limit_reached: as error_code on a schedule (409) and on an edit that would make a post a draft or move one to another account (400), and as code on a retry (409).

What to change: to share the Instagram reel while TikTok saves a draft, schedule TikTok alone with only_create_draft: true on POST /projects/{projectId}/schedule and the reel without it on POST /devices/instagram/avatar-projects/{avatarProjectId}/posts (or schedule_instagram_post). Leave share_to_facebook and trial_reel out of a draft, and once an account has its 10 drafts, schedule posts for it instead.

BreakingChangedAccounts

The high-demand notice on account seats no longer depends on your order

When you buy account seats, the notice that new accounts may take up to 3 days to be created now shows whenever new accounts for your workspace may take that long, whatever seats you pick.

Removed from GET /devices/accounts/seat-options: max_purchasable_seats, high_demand_from_seats and high_demand_from_seats_by_platform. purchase_account_seats no longer returns high_demand_platforms.

Changed: high_demand is true while new accounts for your workspace may take up to 3 days to be created, and while it is true every checkout purchase_account_seats creates carries high_demand_notice, whatever its seats.

What to change: show the notice when high_demand is true, and stop reading the removed fields.

ChangedPosting & scheduling

TikTok business accounts and sounds not cleared for commercial use

TikTok lets a business account post only with sounds cleared for commercial use, so a post with another sound now fails right away with that reason instead of a generic sound error. From then on, the sound searches for that account's avatar list only cleared sounds.

New error_code on a failed TikTok post: sound_not_licensed. Nothing was posted, and Pamba does not retry it: pick another sound with set_slideshow_sound or set_video_tiktok_sound first, or the retry fails the same way.

ImprovedAccounts

Accounts without an avatar count everywhere

Your accounts that no avatar is linked to now count wherever an avatar's would. Instagram and Facebook warnings about them reach your workspace, your weekly recap counts their views, and your Facebook ones show in Analytics and in your accounts list.

GET /facebook/analytics/dashboard and GET /facebook/analytics/accounts add unassigned_accounts: the workspace's Facebook accounts signed in on one of its phones that no avatar claims, directly or through their Instagram account, in the same shapes as Instagram's. scope_overview, the dashboard's video lists and GET /facebook/analytics/videos count them too.

GET /devices/accounts/inventory and list_accounts list those Facebook accounts with their avatar fields null; a Facebook account follows its Instagram account, so assign that one to an avatar. get_analytics_summary lists them for Facebook under the pseudo-avatar unassigned.

ImprovedComments

Automations wait while Instagram blocks an account's messages

When Instagram stops one of your Instagram accounts from sending messages, its comment-to-DM automations hold that account's messages until the block ends. The automation names the account, and the account picker says when its DMs resume.

New fields on each accounts item of GET /comments/automations: messaging_restriction (incident_id, restriction, added_on, ends_on; null when there is none) and messaging_resumes_on. list_comment_automations adds messaging_restriction per account, with resumes_on.

New detail value: messaging_restricted, on queued runs and on a not_sent run whose comment turned 7 days old while held, in GET /comments/automations/{automationId}/activity, the automations of GET /comments and list_comment_automation_activity.

Read the guide
BreakingChangedComments

Comment-to-DM automations send the link once they reply

An automation now sends two messages. The first asks the person to reply and has no link; when they reply yes, Pamba sends the second, with your link. Instagram doesn't let someone who doesn't follow you tap a link until they reply, and sending links only to people who asked for them keeps your accounts from being flagged as spam.

POST /comments/automations and create_comment_automation require follow_up_text, the message with the link, up to 1,000 characters. A save checks both messages: 400 link_in_first_message for a link in dm_text, 400 follow_up_required when follow_up_text is missing or only a link, 400 follow_up_too_long past 1,000 characters. Turning an automation on needs follow_up_text; one that is off without it can still be saved while it stays off.

Existing automations moved to two messages: a message with a link became follow_up_text, after a default first message in dm_text; one with no link, or only a link, kept its message and was turned off until it has a second one.

New fields: follow_up_text on an automation, and replied_yes and links_sent in its last_7_days; follow_up_status, follow_up_detail, follow_up_sent_at and replied_at on each run of GET /comments/automations/{automationId}/activity; follow_up_status, follow_up_detail and replied_at on each automations item of GET /comments.

What to change: move the link from dm_text to follow_up_text, and send follow_up_text when you create an automation or turn one on.

Read the guide
ChangedAccounts

A new Instagram account's name can arrive a few days after it is made

When a new Instagram account is made on a phone that already holds another Instagram account, Instagram asks for no name at signup, so Pamba now sets the name you gave the account, or its avatar's, about three days after it is made. If you change the name before then, the name you set is the one it keeps.

PUT /devices/accounts/seat-usernames and set_account_username: on a phone that already holds an Instagram account, first_name and last_name (the name POST /devices/accounts/username-suggestions, POST /devices/accounts/username-check, suggest_account_usernames and check_account_username offer included) or the linked avatar's name are set about three days after the account is made; with neither, the account has no name. A name changed before then is the one kept. Elsewhere the name goes on at signup, as before.

NewAgent & MCP

A changelog you can follow

Every change you would notice in Pamba is listed here, newest first, with an Atom feed to follow it. Ask Pamba in chat what changed and it tells you which changes touch your workspace.

New public route: GET /changelog (no key needed), with audience, area, since, before and breaking filters. Atom feeds at /changelog/feed.xml and /changelog/api/feed.xml.

New tool: get_recent_changes, the same entries for the agent and MCP clients.

NewPosting & scheduling· Updated Nov 3

Mention accounts in TikTok captions

Write @handle in a video's or a slideshow's caption and the post links that account, on TikTok as on Instagram. A TikTok caption can mention up to 5 accounts.

A TikTok video's caption on POST /projects/{projectId}/schedule, PUT /devices/tiktok/posts/{postId}, schedule_post and update_scheduled_post now takes @handle mentions, at most 5, which post as linked mentions. An @ that starts no handle (an email address, a link, a lone @), a handle run straight into other letters or a hyphen, a sixth mention or the posting account's own handle is refused, with a 400 from the routes and the same reason from the tools, on an edit that moves the post to that account too.

Since 2026-11-03 a slideshow's caption on POST /slideshows/{slideshowId}/schedule and schedule_slideshow_post, and its edit on PUT /devices/tiktok/posts/{postId} and update_scheduled_post, takes @handle mentions too: on its TikTok photo post under the same rules as a video's, and on its Instagram carousel or reel as written, Instagram linking the handle, as on a reel. Both used to refuse any @.

New error_code on a failed TikTok post: mention_not_offered. TikTok's mention list offered no account for a handle in the caption, so nothing was posted, and Pamba does not retry it: fix the caption first, or the retry fails the same way.

Read the guide
ChangedPosting & scheduling

Instagram posts with a flagged caption

When Instagram stops a post because its caption looks like captions others reported, the post fails with that reason. Change the caption and retry it.

New error_code on a failed post: ig_caption_flagged. Nothing was posted, and Pamba does not retry it: change the caption with PUT /devices/tiktok/posts/{postId} or update_scheduled_post first, or the retry fails the same way.

ChangedPosting & scheduling

A failure code for Instagram media that could not be prepared

An Instagram post whose video or pictures could not be prepared for posting fails with its own code, and Pamba retries it.

New error_code on a failed Instagram post: phone_media_failed. The post's video or pictures could not be made into the copy a phone receives, and nothing reached the phone; Pamba retries it like any failure before the phone.

BreakingChangedAccounts

High demand on account seats is read per platform

When you buy account seats, the notice that new accounts may take up to 3 days to be created now looks at each platform in your order, so an order only for platforms without high demand is not told to wait.

New field: high_demand_from_seats_by_platform on GET /devices/accounts/seat-options, per platform the smallest order, in seats across platforms, that is told to wait; a platform absent makes no order wait. purchase_account_seats adds high_demand_platforms, the platforms where every order waits, and its checkout's high_demand_notice says when an order waits.

Changed: high_demand_from_seats is null until every platform is listed in the new field, then the largest of its values, and high_demand is true only when every value is 1.

Changed: linking an account by its password (POST /devices/instagram/avatar-projects/{avatarProjectId}/link-account, POST /devices/facebook/avatar-projects/{avatarProjectId}/link-account, link_social_account) answers 409 no_workspace_phone when the workspace holds the Instagram side of none of its phones; an Instagram seat brings one.

What to change: read high_demand_from_seats_by_platform with open_slots to tell whether an order waits (over MCP, the checkout's high_demand_notice): high_demand_from_seats and high_demand now speak only for an order that waits on every platform.

BreakingChangedAccounts

Imports only you can move on come back to you

When an account import needs something only you can do, such as approving the sign-in on your own phone, it comes back to you with the reason, and you retry it once that's done.

An import in with_team can now move to needs_customer, with a failure. New failure.code: approve_on_device, a sign-in approval asked on the owner's own phone that never came; retry it once that phone is at hand. An import whose wait for that approval ends unanswered now reads approve_on_device, where it read code_timeout. On GET /devices/accounts/imports, GET /devices/accounts/imports/{importId} and get_account_import_status.

What to change: handle approve_on_device as a needs_customer failure the owner clears on their own phone before a retry, as you handled code_timeout.

BreakingRemovedWarming

Boost routes and tools removed

The routes and tools that put a temporary boost on an account's warming are gone. An account's warming settings are its search terms and its search and follow switches.

Removed, now 404: GET, PUT and DELETE /devices/accounts/warming/boost.

Removed tools: get_account_warming_boost, start_account_warming_boost, end_account_warming_boost.

Now refused (400, nothing applied): PUT /avatars/projects/{projectId}/selected-avatar with a warming_config that sets anything but the search terms and the search and follow switches.

Changed: a warming_config without search_terms leaves the terms as they are (it used to reset them).

What to change: drop the boost calls, and send only search terms and switches in warming_config.

NewComments

Comment-to-DM automations

Pick a word. When someone comments it on a TikTok or Instagram post, Pamba replies to the comment and sends them a DM with your link. An automation covers every post on the accounts you choose, and the Comments page shows each reply and message it sent.

Routes: GET and POST /comments/automations; GET, PATCH and DELETE /comments/automations/{automationId}; GET /comments/automations/{automationId}/activity.

Tools: create_comment_automation, list_comment_automations, get_comment_automation, update_comment_automation, delete_comment_automation, list_comment_automation_activity.

New field: automations on each GET /comments thread and in list_comments.

Read the guide
ImprovedComments

When comments were last checked

The Comments page says when Pamba last checked your accounts for new comments.

New fields: checked_at on GET /comments, GET /comments/videos, list_comments and list_comment_videos; automations_on on GET /comments/videos.

BreakingChangedAccounts

Archived accounts are read-only

An archived account keeps its posts and history in Analytics, and nothing runs on it: no posts, warming, comments or profile edits.

Every request that would run or change anything on an archived account, its status included, is refused with 409 account_archived, and the tools return status account_archived. Work still queued for it leaves the schedule with the same code, and a post on it fails as tiktok_account_archived (TikTok) or instagram_account_paused (Instagram).

What to change: treat account_archived as final. To bring an archived account back, contact support.

NewPosting & scheduling

Trial reels, and Professional accounts from Pamba

Post a reel as a trial. Instagram shows it first to people who don't follow you, and you choose whether it ever reaches your followers or only once it performs well. You can also switch an Instagram account to Professional and pick its category.

trial_reel (and instagram_trial_reel where a request schedules both platforms) on the Instagram schedule routes and tools: release_to_followers_never or release_to_followers_once_it_performs_well. remove_trial_reel on update_scheduled_post.

instagram_account_type, instagram_category and instagram_show_category on POST /devices/accounts/profile-edits and update_account_profile.

Read the guide
NewWorkspaces & API keys

Create and set up a workspace from an API key

One API key can create a workspace, set it up and make a key for it, with no sign-in.

POST /workspaces takes setup: "complete" with niche_description and what_they_do; its 201 adds setup_status and setup_message.

POST /api-keys takes workspace_id; create_api_key takes key_workspace_id and returns workspace_id.

NewPosting & scheduling

First-frame covers

A video post's cover can be its first frame.

first_frame_cover on POST /projects/{projectId}/schedule, POST /devices/instagram/avatar-projects/{avatarProjectId}/posts, PUT /devices/tiktok/posts/{postId}, schedule_post, schedule_instagram_post and update_scheduled_post, and on post payloads.

New failure codes, which Pamba retries: cover_not_set, ig_cover_not_set.

BreakingChangedPosting & scheduling

The same content goes out once per platform

The same video or slideshow can't be scheduled on two accounts of one platform. Posting it to a TikTok and an Instagram account still works.

POST /projects/{projectId}/schedule, POST /devices/instagram/avatar-projects/{avatarProjectId}/posts and POST /slideshows/{slideshowId}/schedule answer 409 duplicate_content; PUT /devices/tiktok/posts/{postId} answers 400 with the same code.

schedule_post, schedule_instagram_post, schedule_slideshow_post and update_scheduled_post return status duplicate_content.

What to change: give each account of a platform its own video or slideshow.

ImprovedSlideshows

One-slide TikTok slideshows

A TikTok slideshow can be a single slide. An Instagram one still needs two.

POST /slideshows/{slideshowId}/schedule and schedule_slideshow_post accept a one-slide TikTok post, which was a 400. An Instagram post still needs 2 slides.

NewPosting & scheduling

AI-generated labels

Label a video post as AI-generated, with TikTok's and Instagram's own labels.

ai_label on POST /projects/{projectId}/schedule, POST /devices/instagram/avatar-projects/{avatarProjectId}/posts and PUT /devices/tiktok/posts/{postId}, and on the tools that schedule or update a video post.

NewPosting & scheduling

Instagram stories

Post stories with an optional link sticker and a song, and add them to a highlight. An account's highlights are listed in Pamba, and you can delete them.

Routes: POST and GET /devices/instagram/accounts/{username}/stories, GET /devices/instagram/accounts/{username}/highlights, POST /devices/instagram/accounts/{username}/highlight-deletes.

Tools: post_instagram_story, list_instagram_stories, list_instagram_highlights, delete_instagram_highlight.

NewCreating videos

Replicate an Instagram reel from its link

Paste a reel's link on the Create page, or hand it to Pamba in chat, and get your own version of it, the way TikTok links already work.

instagram_url on POST /projects/replications; new GET /projects/replications/instagram-source.

New tool inspect_instagram_reel; replicate_project takes instagram_url; get_replication_status adds source_instagram_url.

Read the guide
Additive changes never need action. Breaking ones always say what to change.