add_ad
ChatGPTAdd one more ad to an existing ad set (from get_ad_campaign): it runs under that ad set’s audience and budget. On Meta more_ads adds up to 9 more in the same call. Meta, TikTok and LinkedIn; Google and Pinterest take new ads as a new campaign. Made paused unless launch is true. Ask the person and wait for their yes before calling it.
add_labels
ChatGPTAdd text labels to the board (its annotations): a title above a group or an item, or a heading on its own. Give above_node_id to title something: the label is placed just above it, lined up with its left edge, and it stays with it when the board is tidied. Leave above_node_id out for a heading that stands alone. Labels are for naming and explaining areas of the board; they are not content a chat reads.
add_to_board
ChatGPTAdd links, existing images, ads, notes and search results to the board, in one call however much there is. To upload original local photos or video files use upload_board_media instead; it opens a picker and saves them onto the chosen board. To add what a search found (or the calls find_in_app found), give from with its result_id and how many to take (the best first): never type its links out. An ad becomes an ad block with its creative and copy. A link (a post, a video, a web page) becomes the right kind of item and Poppy reads it in the background, so its text is not available right away. Existing images use image_url instead of url, including extensionless CDN URLs returned for vault image items. image_width and image_height preserve their aspect ratio. A creator's profile link becomes a creator profile block; a YouTube channel link becomes a channel block. A note is text you write, in markdown. Give group_title to put what you add together in a group of that name: do this whenever you add two or more related items, and never for a single item unless the person asked for a group. When the board already has a group with that name (as the person writes it: 'the Hooks group' is Hooks), it goes into that group, never a second one beside it; new_group makes another of the same name only when the person asks for one. To add to a group the person names or points at, give its name as group_title or its group_id from list_board_nodes. Two or more items with no group_title still arrive in one group; set loose to true only when the person asks for them not to be grouped. A group they ask for by name with nothing to put in it yet ('make a group called Hooks') is a group_title (or groups entry) with no items: it is made empty, never filled with placeholder notes. For several groups at once, give groups instead, one entry per group, each with an optional heading above it; items given alongside groups land on their own under them (a brief, a direction note). Give new_chat to also make a chat beside what you add with all of it wired in, or connect_to_chat_id to wire it into an existing chat. Returns the ids of the items, groups and chat it made.
add_vault_to_board
ChatGPTPut one of the person's vaults on the board as a live card, the way the app does: the whole vault, or one of its groups with group_id. The card shows what the vault holds and keeps up with it as the vault changes; it can be wired into a chat like a group. Use this when they ask for a live vault (or a vault's group) card on the board. To use particular photos as image references, import those image items with add_to_board image_url instead. vault_id and group_id come from list_vaults. A vault already on the board is not added twice.
arrange_board
ChatGPTLine items up in a neat grid. Give node_ids to tidy only those; leave it out to tidy everything that is not inside a group.
board_picture
ChatGPTTake a picture of a board you can edit and return the image's link, to see how it looks (its layout, whether everything loaded). By default it is the board's share image, 1200x630, the same picture its link preview and the board list show, refreshed if the board changed. frame 'whole' (or full:true) is a separate, taller picture with the whole board in frame; frame 'top' is the top of the board (on a content system template: its title, Start here, the results banner, Step 1 and Step 2). Both are kept apart from the share image, so they never change the board's thumbnail or link preview. A picture takes up to a minute.
cancel_scheduled_post
ChatGPTCall off a post that has not gone out yet: it comes off the schedule. A published post cannot be called off. post_id from list_social_posts or get_content_calendar. The person approves it first.
change_ad_audience
ChatGPTAdd people to, or take people out of, one of their customer list audiences on Meta (add_people or remove_people, each an email, a phone with its country code, or both, up to 10,000), by audience_id and its exact audience_name from get_ad_setup. Only lists made through Poppy; ones made in Meta change there. Meta applies it within a few hours. It spends nothing but sends their customers to Meta: ask the person and wait for their yes before calling it.
change_ads
ChatGPTPause or resume a campaign, an ad set or one ad (status); change a campaign’s or ad set’s budget (budget_amount, in the account’s currency; daily or lifetime stays as it is); or on Meta change who an ad set reaches or when it runs (level ad_set with any of countries, age_min, age_max, gender, interests, audiences, excluded_audiences, start_time, end_time: only those change, each list given whole as it should be now, from get_ad_campaign who_sees_it). Everything that changes about one ad set’s audience and dates goes in ONE call, never split (two calls at once can undo each other); the answer shows who it reaches after. A status, a budget, or an ad set’s audience and dates: one of the three per call. Ask the person and wait for their yes before calling it.
chat
ChatGPTSend a prompt to a Poppy chat node. Poppy's AI answers with the chat's knowledge base attached. The message and its answer are saved in the chat: in the conversation it shows on the board (one is started if it has none), or in conversation_id to continue another saved conversation. Costs the user Poppy credits. Returns the reply, credits used, and credits remaining in the pool that paid (credits_pool: personal or team).
connect_app
ChatGPTGive the person a way to connect one of their apps when it isn't connected yet, needs a reconnect, or they ask to connect it. Says whether it is connected and gives connect_url, the page that connects it. In Poppy's own chat they see a Connect button for it; elsewhere, give connect_url as a link. Connecting is theirs to do: then wait for them to say it's done.
connect_to_chat
ChatGPTWire items or groups into a chat, so the chat can use them. Connect a group instead of its items when all of them belong.
create_ad_audience
ChatGPTMake a custom audience on a Meta ad account, to reach or leave out with an ad set: their customers (customer_list, with people: each an email, a phone with its country code, or both, up to 10,000), people who visited their site (website: pixel_id from get_ad_setup pixels, optional page_contains, days up to 180), people like one of their audiences (lookalike: source_audience_id from get_ad_setup audiences, country, percent 1–10), or people who engaged with their Facebook Page or Instagram (engagement: engaged_with, source_id the Page id or its instagram_id from get_ad_setup run_as, days up to 365). Meta fills it within a few hours. It spends nothing; ask the person and wait for their yes before calling it.
create_ad_campaign
ChatGPTMake a new campaign on one of the person’s ad accounts: the campaign, its ad set (audience, budget, dates) and its ad (picture or video, copy, button, link), in one call. On Meta: goal website_leads (sign-ups, leads) or website_sales optimizes for results on their site, counted by a pixel (conversion: pixel_id plus an event like COMPLETE_REGISTRATION or PURCHASE, or page_contains for a thank-you page); story_media adds a 9:16 picture or video for Stories and Reels; it can reach or leave out custom audiences (audiences, excluded_audiences from get_ad_setup) and make up to 10 ads at once (the first in the top-level fields, the rest in more_ads, each with its own picture or video and words); the answer names each ad made or not. What counts as a result is the person’s choice: ask when they didn’t say. Call get_ad_setup first for the platform’s rules and who it runs as. The budget is the one the person gave, in the account’s currency: never pick one for them. It is made paused. In Poppy’s Copilot launch true starts it once they approve; anywhere else it always waits paused and starts with change_ads (status active) after they say so. Ask the person and wait for their yes before calling it (Poppy’s app also shows them a card). A rule it breaks comes back by field: fix copy, link, button or ids yourself; ask the person about the budget, currency, audience or dates.
create_board
ChatGPTCreate a new empty Poppy board with no template, copied content, groups or chats. Use this for a new board, including a board for a topic, platform or customer. A topic such as Instagram reels never implies a template. Only create a board when asked for a new board; use the current or specified board for content requests. Returns board_id and url; use that board_id for any requested content or edits on the new board.
create_board_from_template
ChatGPTOnly when the latest request explicitly asks to use a template, duplicate or copy an existing board: make a named copy, as the app's "Use Template" and "Make a copy" buttons do. A copy requested earlier is not a new copy request. Never use this for an ordinary new board, a topic, a platform or a script request; create_board makes a blank board. Groups, notes, videos, links and ads are copied. Chat blocks start fresh without saved conversations; embedded chatbot blocks are left out. Use create_chat to add any new chats requested. template: the source board's link or id. Returns the new board_id and url; read the copy with list_board_nodes and use its fresh node ids for requested edits.
create_carousel
ChatGPTGenerate an image carousel onto the board, as a chat does: 2 to 10 slides, each an AI image with any words drawn into it. It spends the person's credits, so make one only when asked, and never ask about its size: decide. master_prompt is the look every slide shares (style, palette, mood, typography); each slide prompt describes that slide's scene in full, its text and where the text sits. format: instagram_post (4:5) for Instagram, Facebook and LinkedIn feeds, story (9:16) for stories and TikTok, square (1:1); auto takes the platform's, else 4:5. The card appears at once and its slides fill in over a minute or two.
create_chat
ChatGPTAdd a new AI chat to the board. Give connect_from_ids only when the person asked for something to be connected: it wires those items or groups into the chat so they become what it knows. Asked just to create a chat, leave it out and the chat starts empty. Returns the chat id.
create_content_projects
ChatGPTCreate finished content blocks on the board. A request to write a script already asks for a video block: use kind: "video", even without saying "save" or "on the board". Do not deliver only reply text or a note unless they explicitly ask for text only or a plain note. Ideas, hooks, advice and outlines alone do not create blocks. Each is a video (a script the creator films), a post (finished text for X, LinkedIn, or Threads), an article (finished long-form writing), or an email (a finished newsletter or email to subscribers). Pick each project's kind from what the person asks for, and make it; never ask which kind they want or talk about choosing one. video: anything filmed (a reel, short, TikTok, YouTube video, script, video idea, or an Instagram or TikTok post). post: written posts to read (a tweet, X post, thread, LinkedIn post, Threads post). article: long-form writing to publish (an article, blog post, Substack or Medium piece, essay, LinkedIn article). email: an email to subscribers (a newsletter, email, email blast, or email campaign; in a sequence, each email is its own piece). When nothing names one: words to be read ("write something", an announcement, an update, "a post") are a post; ideas to make, film, or record, or plain "content", are a video. They can switch a project's kind on its card. Never choose a platform; that is picked when posting. Match the requested quantity from 1 to 6: an explicit number wins; singular wording means one; unnumbered plural wording such as "some", "a few", "several", or "ideas" means three; otherwise one. Several pieces are each complete and different. Every piece needs its title, format, goal, angle, and why it fits, and its kind's body as described in its fields. Read what the board has first when they want it based on their sources. Give chat_id when a chat on the board asked for them, to place them beside it. Returns each project's id.
create_folder
ChatGPTCreate a named board folder, for example Onboardings · Oct 12. Reuses your existing folder with the same name in the same workspace, so retries do not make duplicates. Returns folder_id and its link. For an existing board, use its team_id from list_boards. For a copy, copy first, then use the returned team_id; do not create its folder before knowing the copy’s workspace. Omit team_id for personal boards; a team key stays in its own team. A folder organizes boards without changing who can access them.
create_mindmap
ChatGPTAdd a mind map to the board: a title at its center and branches around it, up to three levels deep. Use it when the person asks for a mind map, or to lay out ideas, a topic or a plan visually. Give connect_to_chat_id to wire it into a chat as something the chat knows. Returns the mind map's id and its outline with each branch's id.
create_vault
ChatGPTCreate a new, empty vault for the user, as the app's "New Vault" does. Returns it like a list_vaults entry (id, name, emoji, url). Then save_to_vault with its id to fill it. Show it to the user by name, linked.
delete_ad_audience
ChatGPTDelete one of their custom audiences from Meta for good, by audience_id and its exact audience_name from get_ad_setup. Only audiences made through Poppy, and never one an ad set still uses (the answer names those ad sets: change them first). Ask the person and wait for their yes before calling it.
delete_ads
ChatGPTDelete a whole campaign (with everything in it) or one ad, from the person’s ad account. It cannot be undone: pausing (change_ads) keeps it. Ask the person and wait for their yes before calling it.
delete_board
ChatGPTMove a board you own to reversible trash, using the app’s archive. Removes it from active boards and disables public sharing. Retains the content, graph and room so restore_board can bring it back. Never permanently purges content. board_name must exactly match its current name, protecting against deleting a different or renamed board. A repeated call does not delete anything further. Do not delete merely because a board is old; use the person’s stated selection or no-show criteria.
delete_items
ChatGPTRemove items from the board. Deleting a group removes everything inside it. In Poppy the person confirms first; over MCP it runs at once and cannot be undone, so only call it for a deletion the person clearly asked for.
disconnect_from_chat
ChatGPTRemove the wires from items or groups to a chat. The items stay on the board.
duplicate_ad_campaign
ChatGPTCopy one of their Meta campaigns with its ad sets, ads, pictures and audiences, by campaign_id and its exact campaign_name. The copy is named "<name> (copy)" and made paused with its ad sets and ads; starting the campaign (change_ads status active) switches on what ran in the original, so it runs like the original. It reaches get_ad_campaigns a few minutes after. For several copies, one call each with copy_number 1, 2, 3… Use it to test a new audience or picture against one that works. It spends nothing until started; ask the person and wait for their yes before calling it.
edit_content_project
ChatGPTChange a content project already on the board: its title, brief, or body. A video's script changes with script (give only the lines that change); a post's with post.text; an article's with article.markdown (its whole body; the title is its headline); an email's with email (its subject, previewText, or whole body as markdown, only what changes). Give kind to switch what it is (video, post, article, or email): its words carry over to the new kind on their own, so give a new body only to rewrite it. Its stage, video style, and recordings are never changed. get_knowledge_base reads a project.
edit_image_titles
ChatGPTChange the HTML video titles underneath existing YouTube image packages. Keep their thumbnail files, avatars and channel details unchanged. Use node_id and the stable cell_index shown in the board map for a gallery image; omit cell_index for a standalone image. This edits existing titles in place, never generates an image. For suggestions only, answer without calling it.
edit_label_text
ChatGPTChange some of a label's words in place: the first time find appears in the label's text becomes replace, and the label keeps all its other lines, links and styling (rename_item rewrites a label as one line). For a template board's title label, e.g. find 'Viral Reels Content System', replace "Sarah's Viral Reels Content System". Refused when the label does not say find; find must sit in one run of text (not across a link or a style).
edit_mindmap
ChatGPTAdd, rename or remove branches of a mind map already on the board, by the ids its outline shows (get_knowledge_base or list_board_nodes gives the outline; create_mindmap and this tool return it). Edits run in order. To rename the mind map itself, use rename_item.
find_creator
ChatGPTFind the account someone means on Instagram, TikTok or YouTube from a name, nickname, show or guessed handle, even typed or heard wrong ("Alex Hermosi", "@alexhormozi"). Searches the library, Google and the platform, then checks each account's profile. Returns candidates best first, with their real name, followers, whether they are verified and how closely the name matches (match, 0-1); confident means the first is clear-cut. Use it before any lookup that takes a handle, unless the person gave the exact handle or a profile link.
find_in_app
ChatGPTFind things in one of the person's connected apps to put on the board: their latest calls (Zoom, Fathom, Fireflies, Grain, Granola), or docs by name (Notion pages, Google Docs, Google Sheets). Lists each one's title and date (and for a call, whether its video comes too), and returns a result_id: add them with add_to_board's from (result_id, and take for how many), never by typing them out. A call lands as a block holding its summary and full transcript right away, and its video (where the app keeps one) plays once it is in. A doc lands as a note of its contents that stays in sync with the doc. Use this, not app_actions, whenever calls or docs should go on the board; app_actions is for reading, asking about or changing one.
generate_images
ChatGPTGenerate images onto the board with AI, as a chat does: each card appears at once and fills in when its image is made (a minute or so). It spends the person's credits, so make only what they asked for. Just make them: never ask about size, shape, model or quality, decide; and when the subject is thin, make a strong best guess from the board and the conversation rather than asking, since a card is easy to redo. Write each prompt as a full scene description. format: where the image goes, which sets its shape (a YouTube thumbnail is always 16:9, a story 9:16): youtube_thumbnail (YouTube thumbnail or video cover, 16:9); widescreen (slide, blog header, link preview, X post or desktop wallpaper, 16:9); instagram_post (Instagram, Facebook or LinkedIn feed post, 4:5); story (story, reel, TikTok or Shorts cover, phone wallpaper, 9:16); square (square post, profile picture, logo or icon, 1:1); pinterest_pin (Pinterest pin or poster, 2:3); banner (website hero, banner or cover photo, 21:9); landscape (landscape photo, 3:2); landscape_4_3 (landscape, 4:3); portrait (portrait photo or print, 3:4). Leave it auto only when nothing says where it goes; auto reads the prompt, else square. model: leave it out unless the person names one; it runs on Poppy's default, gpt-image-2.5-flare (gpt-image-2.5-sunburst is slower, for the most detail). quality: leave it out unless they ask for higher quality or a draft. reference_ids: image nodes or YouTube video nodes already on the board to work from (a style, a face, a product, or a YouTube thumbnail). A YouTube node supplies its thumbnail. Import vault photos as image_url first, then use the returned image node ids. Put them in a group by name with group_title (one already on the board with that name is used), or by its group_id, or wire them into a chat with connect_to_chat_id.
get_ad_campaign
ChatGPTOne campaign in full: its ad sets and every ad in them. The campaign’s goal (Sales, Leads, Website visits…) and numbers including conversions (results) and costPerConversion. Each ad set has its budget, what it counts as a result (counts: the pixel event), when it runs (runs), Meta’s learning phase (learning) and on Meta who it reaches now (who_sees_it: countries, ages, gender, interests, custom audiences); each ad its copy, picture or video, review status, rejection reason and numbers. The ad set and ad ids are what add_ad, change_ads and delete_ads take.
get_ad_campaigns
ChatGPTOne ad account’s campaigns, newest first: each one’s id, status, budget, goal and numbers (spend, impressions, clicks, ctr, conversions), with the account’s totals. Money is in the account’s currency.
get_ad_setup
ChatGPTWhat a new ad on this account takes, before making one: the platform’s goals, media, headline and text lengths, buttons (calls_to_action), the smallest budget, and who the ad can run as (run_as: the Facebook Pages, with their instagram_id, TikTok identities or LinkedIn Pages, with the default). On Meta also the account’s pixels (for website_leads and website_sales, and website audiences) and its custom audiences (id, name, kind, size), to reach or leave out. With interest_search, also interests to target by those words.
get_board_media_upload
ChatGPTCheck upload_id from upload_board_media after the person finishes the picker. Ready means every selected file is saved to the destination board. board_items provides each node_id and durable public url, including videos. Use media_id values in media_ids for multiple photos, or a single public url as media_url, to prepare_social_post or post_to_social when requested; never pass a video block id as project_id. Do not keep polling while the person selects files. Never publishes.
get_brand_ads
ChatGPTList Facebook/Instagram ads for a brand (brand_id from search_ad_brands) or search all ads by keyword. Each ad has copy, CTA, format, media links, run days and a transcript excerpt.
get_content_calendar
ChatGPTWhat is on the person's content calendar between two days: posts scheduled to go out (with post_id), and content projects planned for a day but not scheduled yet (with project_id and a link to open them). Defaults to the next 30 days. calendar_url opens the calendar in Poppy (Content Studio, also in the sidebar of their boards): give it when they want to see their calendar or ask how to get back to it.
get_content_project
ChatGPTRead saved video projects with their exact scripts and the latest recorded take or current finished video. Shows a script/video card with a Record button. Use this to show a previously created script or video, or check after filming. Find node_ids with list_board_nodes when needed. This reads only: it never creates a project, shares it or starts recording.
get_creator
ChatGPTOne library creator's profile: followers, niches, what they mostly make, posting cadence and recent library posts with their full transcripts.
get_creator_posts
ChatGPTA creator's recent posts on Instagram, TikTok, YouTube or LinkedIn, best outliers first, with views, engagement and outlier multiplier. Uses a cache and scrapes when it is stale (can take a minute). Counts toward the live search limit.
get_credits
ChatGPTThe user's Poppy credits: remaining, used this month and the limit, for the pool their chats are billed to (pool is personal or team; a team board bills its team). Free. Chat is the only tool that spends credits.
get_knowledge_base
ChatGPTThe text of a board's content (transcripts, docs, notes, pages, ads), the same text a Poppy chat gets. Set include_images to true when you need to visually inspect image cards or image ads, or use them as generation references: Copilot receives their actual pictures. Text-only reads omit image input by default. node_id picks the scope: a chat id reads everything wired into that chat, a group id everything inside the group (nested groups included), a content node id that item alone; omit it for the whole board. Returns scope (kind and title) and the items. Free: use it when you can reason over the material yourself instead of calling chat.
get_post
ChatGPTEverything the library knows about one post: full transcript, on-screen text, hook, CTA, summary and taxonomy. Accepts an Instagram URL, shortcode or post id from a library search.
get_social_account_stats
ChatGPTHow the person's social accounts are doing as accounts: followers and their growth, reach and views, audience (age, gender, country), each against the period before, plus top posts. Platforms share different things: Instagram, YouTube and Facebook give reach and audience; LinkedIn company pages give page stats; TikTok and X give followers and their posts' totals.
get_social_media_upload
ChatGPTCheck upload_id from upload_social_media after the person finishes choosing their files. When status is ready, use every returned media_id in media_ids on prepare_social_post or post_to_social, preserving photo order. Never publishes. Do not keep polling while waiting for the person to select files. Temporary URLs are for social publishing, not permanent board files.
get_social_stats
ChatGPTHow the person's posts are doing: totals, each platform, and their best posts over a number of days.
get_vault_item
ChatGPTReturn a vault item's full text (transcript, post copy or note), visual description and links. An image item includes image.url and known width/height: import it with add_to_board image_url to keep it an image node usable as a generation reference, including extensionless CDN links. A plain web page item has no text, only a link and a preview image.
group_items
ChatGPTPut items that are already on the board into a new group. Chats, groups and items already inside a group cannot be grouped.
lay_out_steps
ChatGPTLay out a board copied from one of Poppy's content system templates (the boards with Step 1 · Brand & Business, Step 2 · My Voice & Content and so on in one column): in each step, what was added goes in rows under the step's own notes (sites, then posts, then creator profiles) and the step's group fits them; then the steps stack again with their headings and step cards, and what sits under the last step follows. Use it after adding to such a board. It changes nothing on a board that is not one of these templates.
list_ad_accounts
ChatGPTThe person’s own connected ad accounts (Meta, Google, TikTok, LinkedIn), each with its ids, platform, currency and spend, clicks and results for the window; which platforms are not connected; and what the AI may do on each (ai_can). Start here for anything about their ads or making one. A platform not connected is connected with connect_app.
list_archived_boards
ChatGPTFind your archived boards, with board_id, name and archived_at. Use restore_board to bring one back. Excludes boards removed from the app’s archive. A team key sees its own team only. Follow next_cursor for more.
list_board_nodes
ChatGPTEverything on a board, groups first: each node's id, kind (Group, Vault group, Chat, Instagram post, YouTube video, Facebook ad, Note, Website, Document...), title, link (url, when it has one) and group_id when it sits inside a group. Groups and vault groups carry item_count: the content items inside them, nested groups included, which is what get_knowledge_base returns for that id. A board with more than 300 nodes is cut (truncated: true, total is the full count); groups come first so they survive the cut. Use the ids with get_knowledge_base. To work in one group (add to it, or edit or read what it holds), give group: its title as the person says it, or its id; the answer is that group and everything inside it, never cut, with each note's id for write_note. Show the board to the user as a markdown table: Kind | Title (linked to url when it has one) | Group (the group's title, or blank); never show ids.
list_boards
ChatGPTThe user's Poppy boards, most recently edited first, each with its name, a link (url) and a short summary of what is on it. team_id and folder_id are included when applicable: use the board's team_id when finding or creating its destination folder, and folder_id to identify boards in an existing folder. Summaries are generated on first request, up to 8 per call (the rest are null until a later call), and refreshed daily. Show boards to the user as a markdown table: Board (name linked to url) | Last edited | What is on it (the summary, or "not summarized yet" when null); never show ids.
list_chats
ChatGPTThe AI chat nodes on a board, each with its name as shown in Poppy (null if untitled), a link to the board (url) and its saved conversations, most recently updated first, each with one short line from its latest message (preview; null beyond the 40 most recent conversations on the board). Use chat_id with chat and new_conversation, or as get_knowledge_base's node_id, and the preview to tell conversations apart. Show chats to the user as a markdown table, one row per conversation: Chat (name linked to url) | Conversation | Last updated | What it covers (from preview); never show ids.
list_content_tags
ChatGPTThe library's content formats, niches, visual styles, hook and CTA types and most-used tags, each with a post count. Call this before filtering a library search or search_creators.
list_creators
ChatGPTBrowse the library's creator roster, paginated, by library post count or followers.
list_folders
ChatGPTYour board folders in a workspace, with folder_id, name and link. Use them with move_to_folder. Use the target board’s team_id from list_boards or its copy result; omit it for personal boards. A team key stays in its own team. Follow next_cursor for more.
list_models
ChatGPTThe AI models chat can use: id, name, provider, context size and credit cost per million tokens, plus Poppy's default; pass an id as chat's model. Also the image models generate_images can use (image_models): pass one as its model only when the person names it.
list_saved_brands
ChatGPTFacebook/Instagram ad brands the user (and their teams) saved in Poppy, with ad counts and their latest ads snapshot. Pass brand_id to get_brand_ads for the full ads.
list_saved_creators
ChatGPTCreators the user (and their teams) saved in Poppy's Discover, with stats and their latest posts snapshot.
list_social_accounts
ChatGPTThe person's connected social accounts, with the account ids posting takes. can_post says whether the person lets you post there. None connected means they connect one from the apps menu in Poppy.
list_social_posts
ChatGPTThe person's recent and scheduled social posts: what each said, where, when, and whether it went out. Each has the post_id that reschedule_post and cancel_scheduled_post take.
list_templates
ChatGPTFind the current templates you can use: your own, your teams’, and approved public templates. Each has its current name, description, category, tags, platform hints, template_id and copyable board_id. Pass board_id as template to create_board_from_template. Choose from these live results instead of hardcoding template ids. Filter by platform or query; follow next_cursor until null for every result. Does not create a board.
list_vaults
ChatGPTThe user's vaults (saved content libraries) with item counts, groups and links (url). Show them to the user by name, linked.
live_search_creators
ChatGPTFind creators on Instagram, TikTok, YouTube and LinkedIn live by topic or name. Counts toward the live search limit.
live_search_posts
ChatGPTSearch Instagram, TikTok, YouTube and LinkedIn live for posts matching a query. Slow (up to a minute) and limited to 10 per minute and 100 per day: search the library first. One platform failing still returns the others, with the failure under errors.
move_items
ChatGPTPut items exactly where you say and, when asked, size them, in board pixels. Read list_board_nodes first: it gives every item's x, y, width and height in the coordinates this takes. Things on the board itself use board coordinates. Things in a group are measured from the group's top left corner and are kept inside it. To place something above an area, line its x up with what is there and set its y so its bottom ends above their top. A picture fills the shape it is given and is cropped to fit, so keep its proportions unless asked otherwise. Only the items named move, and the answer says where each one landed. Tell the person what changed in plain words, never in coordinates. To tidy many things into rows instead, use arrange_board.
move_to_folder
ChatGPTMove a board you own into one of your folders in the same workspace. Pass folder_id from list_folders or create_folder. folder_id:null moves it back out to the main boards list. Does not transfer ownership or change the board’s sharing or workspace.
move_to_group
ChatGPTMove items already on the board into an existing group (from loose, or out of another group): they are laid out after what it holds, and the group grows to fit. To make a new group of loose items, use group_items.
new_conversation
ChatGPTCreate a named, saved conversation on a chat. Pass its conversation_id to chat to keep history.
plan_content
ChatGPTPut a content project on the person's calendar for a day, without posting or scheduling it (date null takes it off). Optionally with the caption and accounts drafted so far, which the post screen picks up. Scheduling or posting it later takes over from the plan.
poppy_ui_add_to_board
ChatGPTSaves one link (a post or a creator) onto a board, from the widget.
poppy_ui_boards
ChatGPTThe person's boards, for the widget's Save menu.
poppy_ui_edit_image
ChatGPTMakes new images from one on the board (an edit, a quick edit, a resize or variations), from the widget. Spends credits.
poppy_ui_image_status
ChatGPTWhere images on a board have got to, for the widget.
poppy_ui_publish_post
ChatGPTPosts the exact content and destinations confirmed in the review card.
poppy_ui_record_content_project
ChatGPTOpens a project-specific recording link. Preserves existing sharing protection.
poppy_ui_suggest_edits
ChatGPTIdeas for changing an image on the board, for the widget.
post_to_social
ChatGPTPost to one or more of the person's social accounts now, or schedule it for a time. Post a content project with project_id (its own video, or a text post's words), or a post of your own (text, with media_ids for its pictures or video, or media_url for one public link). Pictures and videos already on a board post straight from there: give their ids from list_board_nodes as media_ids, several in order for a carousel, never asking the person to upload them again. Only for files that are not on a board yet, upload_social_media opens a picker; get_social_media_upload returns media_ids when ready. text is the caption exactly as it goes out, never a placeholder; a project uses its own caption when text is left out. Only accounts with can_post. The person sees exactly this and approves it first. A post for now can come back as posting: it is going out and shows on the account within a few minutes, so never post it again. A scheduled post comes back with calendar_url, where they see it on their calendar in Poppy: give them that link. A video that is not filmed or exported yet cannot go out: the answer says so with a link to open it. Instagram, TikTok and YouTube need a video or image.
prepare_social_post
ChatGPTPrepare a post or scheduled post for the person to review. Never posts. Returns current account choices, the exact caption and media, and a review card in supported clients. The person posts using its Post or Schedule button. If no card is available, show the exact accounts, caption and time, wait for their yes in their next message, then call post_to_social with the returned input unchanged.
remove_from_group
ChatGPTTake items out of the groups they are in: they sit just beside their old group.
rename_item
ChatGPTChange the title of an item, a group, a chat or a mind map on the board, or a label's or heading's words (they keep their size and color).
reschedule_post
ChatGPTMove a post that has not gone out yet to another time. post_id from list_social_posts or get_content_calendar. The person sees the post and the new time and approves it first.
restore_board
ChatGPTRestore a board you own from reversible trash, keeping its content and graph. It comes back with public sharing off; use share_board if you want to publish it again. Restores its folder when that folder still exists in the same workspace. An already restored board is returned without changing it. Never overwrites an existing board.
save_to_vault
ChatGPTSave links or text to a vault. Each URL on its own line is saved as its own item; all other text is saved as one note, blank lines included. Up to 20 entries per call, the note included; items come back links first, in the order given, then the note. YouTube, TikTok, Instagram, LinkedIn, X, Facebook and Loom links are transcribed and analyzed in the background. A Facebook Ads Library link to one ad (facebook.com/ads/library/?id=…) is saved as that ad: its creative, copy and CTA, transcribed and analyzed as an ad on a board is. A plain web page is saved as a link with a preview image only, no page text. Omit vault_id to use the default vault. New saves can take up to a minute to show up in search_vault.
search_ad_brands
ChatGPTFind brands in the Facebook/Instagram ad library by name, with total and active ad counts.
search_creators
ChatGPTFind creators in the library by name or handle ("hormozi") or by what they make ("saas founders"). Returns followers, library post count, what they mostly make and matching posts.
search_posts
ChatGPTSearch Poppy's content library: Instagram reels and carousels from about 1,500 curated creators, refreshed daily, each tagged with niche, content type, visual format, hook, CTA and tags, with an outlier multiplier (views vs that creator's baseline; 3x+ is a breakout). Give a query (a topic, a phrase, or one taxonomy word like "yapping" or "green screen"), refine filters, or only filters. Keep the query to one idea: stacking several taxonomy words, in the query or as refine filters, narrows to posts tagged with all of them and usually returns few or none, so search one idea at a time. Each post carries its full transcript. Fast and free: prefer it over live_search_posts.
search_vault
ChatGPTSearch saved vault content by meaning and keywords. Searches every vault the user can see unless vault_id is set.
set_item_notes
ChatGPTSet the notes for the AI on a post, video, creator profile or link on the board: the box under the card where a person adds context the chat reads with it (why it is there, its views). Replaces what the box held; an empty text clears it. Notes and groups have no such box: change a note's text with write_note.
share_board
ChatGPTMake a board you own public and return its share link, or turn public sharing off. When public, anyone with the link can view without signing in, and signed-in visitors can edit. Ownership does not transfer. Making it public also removes its owner-only private setting. is_public:false stops new public access while preserving its current workspace access. This is a publish action; explain the access before sharing. board_name must match the current name. Templates are managed through template settings.
ungroup
ChatGPTUngroup a group as its Ungroup button does: what it held stays where it is, its wires to chats move to each item, and the group itself goes. Nothing it held is deleted.
upload_board_media
ChatGPTUpload original local photos or a video directly to an existing Poppy board. Returns an upload picker and upload_id. Give upload_url as an Upload files to your board link if the client cannot show the picker. The person selects the files; do not claim to access local paths or attachment bytes. Files are saved as ordinary board images/video blocks with durable public URLs, without a manual drag into Poppy. Then get_board_media_upload returns board_items with node_id and public url. Use returned media_id values in media_ids for a photo carousel, or a public URL as media_url for one file, to prepare a social post; a board video is not a project_id. Never publishes. Up to ten photos (20 MB each) or one video (500 MB).
upload_social_media
ChatGPTLet the person upload a local image, photo carousel or video for a social post, when the files are not on a board yet: pictures and videos already on a board are posted by their ids (media_ids), never uploaded again. No public URL or board is needed. Returns an upload picker and upload_id. In supported clients the picker appears in chat; otherwise give upload_url as an Upload photos or video link. The person selects the original files. Then get_social_media_upload returns media_ids for prepare_social_post or post_to_social. Do not ask for base64 or claim an attachment was uploaded before status is ready. Never posts. Files are temporary: unused uploads expire after 24 hours; posted files are removed after a retry window. Up to 10 pictures (20 MB each), or one video (500 MB). Schedule within 88 days of uploading.
write_note
ChatGPTChange the text of a note that is already on the board. "replace" swaps the whole note, "append" adds to the end. To make a new note, use add_to_board.