ads_account_get
ChatGPTGet one ad account: name, currency, status, billing_status, balance, amount_spent, spend_cap, minimum_daily_budget, funding_source, usable and unusable_reason (fields vary by network). Pass profile_id when the same ad account is reachable through several ads profiles.
ads_account_health
ChatGPTLive check of whether an ad account can run ads right now. Returns { id, status, ready, blockers, checks: [{ id, ok, message }] }. status is ok, attention (fixable, such as a missing payment method) or blocked (disabled or closed). Run this before creating or boosting an ad.
ads_accounts_list
ChatGPTList the ad accounts reachable through the connected ads profiles (Meta Ads and Google Ads). Start here: other ads tools need an ad account id. Returns { total, page, per_page, data: [{ id, name, currency, status, platform, profile_id, billing_status, usable, unusable_reason, ... }] }. status is active, restricted, disabled or closed. An ads connection is its own profile and is connected from the Postproxy app, not through profile_groups_initialize_connection.
ads_ad_analytics
ChatGPTLive performance report for one ad over a date range. Returns { id, kind, platform, currency, range, summary, daily: [...], breakdowns, unsupported_breakdowns, cached }; summary and each daily row carry the full metric set (spend, impressions, reach, clicks, ctr, cpc, cpm, conversions, roas, video metrics, ...). A repeat within 5 seconds returns the previous answer with cached: true. For many objects at once use ads_insights.
ads_ad_archive
ChatGPTArchive an ad: it stops delivering and is hidden from the network's default views. Meta only; Google Ads answers 501. Returns the ad plus updated; when it was already in that state nothing is sent and the answer carries updated: false with a skipped_reason.
ads_ad_delete
ChatGPTDelete an ad on the ad network. This cannot be undone. Its ad set and campaign are deleted too when Postproxy created them and nothing else is left in them. Returns { deleted, id, platform_id, status, removed_parents }. The row stays readable with status deleted.
ads_ad_get
ChatGPTGet one ad with its latest synced metrics. Returns the ad object: { id, kind, platform, platform_id, ad_account_id, campaign_id, ad_set_id, name, status, platform_status, budget, schedule, targeting, review, metrics, ... }. Pass live=true to refetch it and its metrics from the network first.
ads_ad_pause
ChatGPTPause an ad so it stops delivering and spending. Only this object is switched; parents and siblings are left alone. Returns the ad plus updated; when it was already in that state nothing is sent and the answer carries updated: false with a skipped_reason.
ads_ad_preview
ChatGPTRender an ad as it appears in a placement. Returns { id, platform_id, previews: [{ format, body }] } where body is the network's iframe HTML. Meta only; Google Ads answers 501.
ads_ad_review
ChatGPTRefetch an ad and return its review state: { id, platform_id, status, platform_status, review: { status, reasons }, issues }. review.status is pending, approved or rejected (Google also approved_limited, with policy_topics). Use it to see why an ad is not delivering.
ads_ad_set_analytics
ChatGPTLive performance report for one ad set over a date range. Returns { id, kind, platform, currency, range, summary, daily: [...], breakdowns, unsupported_breakdowns, cached }; summary and each daily row carry the full metric set (spend, impressions, reach, clicks, ctr, cpc, cpm, conversions, roas, video metrics, ...). A repeat within 5 seconds returns the previous answer with cached: true. For many objects at once use ads_insights.
ads_ad_set_archive
ChatGPTArchive an ad set: it stops delivering and is hidden from the network's default views. Meta only; Google Ads answers 501. Returns the ad set plus updated; when it was already in that state nothing is sent and the answer carries updated: false with a skipped_reason.
ads_ad_set_delete
ChatGPTDelete an ad set on the ad network. This cannot be undone. Stops all delivery under it. Returns { deleted, id, platform_id, status, removed_parents }. The row stays readable with status deleted.
ads_ad_set_get
ChatGPTGet one ad set with its latest synced metrics. Returns the ad object: { id, kind, platform, platform_id, ad_account_id, campaign_id, ad_set_id, name, status, platform_status, budget, schedule, targeting, review, metrics, ... }. Pass live=true to refetch it and its metrics from the network first.
ads_ad_set_pause
ChatGPTPause an ad set so it stops delivering and spending. Only this object is switched; parents and siblings are left alone. Returns the ad set plus updated; when it was already in that state nothing is sent and the answer carries updated: false with a skipped_reason.
ads_ad_sets_list
ChatGPTList ad sets (Google: ad groups) across ad accounts. Returns { total, page, per_page, data } from the last background sync (hourly for accounts with live ads). Each row is an ad object with kind ad_set.
ads_ads_list
ChatGPTList ads across ad accounts, including ones created outside Postproxy (source: platform). Returns { total, page, per_page, data } from the last background sync (hourly for accounts with live ads). Each row is an ad object with kind ad, review status and lifetime metrics. Filter by post_id to find the ads boosting a post.
ads_campaign_ad_schedule_get
ChatGPTGet the hours a Google Ads campaign runs: { data: [{ day, start, end, bid_modifier }] }. An empty list means all hours. Google Ads only; other networks answer 501.
ads_campaign_ad_schedule_update
ChatGPTReplace the whole ad schedule of a Google Ads campaign. An empty schedule runs the campaign at all hours. Google Ads only; other networks answer 501.
ads_campaign_analytics
ChatGPTLive performance report for one campaign over a date range. Returns { id, kind, platform, currency, range, summary, daily: [...], breakdowns, unsupported_breakdowns, cached }; summary and each daily row carry the full metric set (spend, impressions, reach, clicks, ctr, cpc, cpm, conversions, roas, video metrics, ...). A repeat within 5 seconds returns the previous answer with cached: true. For many objects at once use ads_insights.
ads_campaign_archive
ChatGPTArchive a campaign: it stops delivering and is hidden from the network's default views. Meta only; Google Ads answers 501. Returns the campaign plus updated; when it was already in that state nothing is sent and the answer carries updated: false with a skipped_reason.
ads_campaign_delete
ChatGPTDelete a campaign on the ad network. This cannot be undone. Stops all delivery under it. Returns { deleted, id, platform_id, status, removed_parents }. The row stays readable with status deleted.
ads_campaign_get
ChatGPTGet one campaign with its latest synced metrics. Returns the ad object: { id, kind, platform, platform_id, ad_account_id, campaign_id, ad_set_id, name, status, platform_status, budget, schedule, targeting, review, metrics, ... }. Pass live=true to refetch it and its metrics from the network first.
ads_campaign_pause
ChatGPTPause a campaign so it stops delivering and spending. Only this object is switched; parents and siblings are left alone. Returns the campaign plus updated; when it was already in that state nothing is sent and the answer carries updated: false with a skipped_reason.
ads_campaign_targeting_get
ChatGPTGet a Google Ads campaign's targeting: { locations, excluded_locations, languages, devices: [{ device, bid_modifier }], location_targeting_type }. Google Ads only; other networks answer 501.
ads_campaign_targeting_update
ChatGPTChange who a Google Ads campaign reaches. Each list you send replaces that list; lists you leave out stay as they are. Ids come from ads_targeting_search (type=location / language). Google Ads only; other networks answer 501.
ads_campaigns_list
ChatGPTList ad campaigns across ad accounts, including ones created outside Postproxy (source: platform). Returns { total, page, per_page, data } from the last background sync (hourly for accounts with live ads). Each row is an ad object with kind campaign. For campaigns with their ad sets and ads nested, use ads_tree.
ads_dsa_recommendations
ChatGPTSuggested values for dsa_beneficiary / dsa_payor (required for ads shown in the EU): { data: ["Acme Inc"], count, cached }. Meta only; Google Ads answers 501.
ads_insights
ChatGPTOne live performance report across many objects of an ad account: one row per object per day. Send either ids (Postproxy ids of that level, same ad account) or ad_account_id (every object of that level). Returns { level, platform, ad_account_id, currency, range, totals: { spend, impressions, clicks }, data: [{ date, platform_id, ...metrics }], unsupported_breakdowns, next_page_token, cached }; totals cover the returned page. For a single object use the *_analytics tools.
ads_keyword_delete
ChatGPTRemove a keyword from a Google Ads ad group. Returns { deleted, id }. Google Ads only; other networks answer 501.
ads_keyword_historical_metrics
ChatGPTGoogle Keyword Planner: search volume and bid ranges for specific keywords. Returns { text, avg_monthly_searches, competition, competition_index, low_bid, high_bid, monthly_searches: [{ year, month, searches }] } per keyword. Creates nothing. Google Ads only; other networks answer 501.
ads_keywords_list
ChatGPTList the keywords of a Google Ads account with their metrics over a date range. Returns { data: [{ id, text, match_type, status, bid, quality_score, campaign_id, ad_set_id, review, metrics }], range }. A keyword id is <ad group id>~<criterion id>. Google Ads only; other networks answer 501.
ads_negative_keyword_delete
ChatGPTRemove a negative keyword, so ads can show for that search again. Google Ads only; other networks answer 501.
ads_negative_keywords_create
ChatGPTAdd negative keywords to a Google Ads campaign (campaign_id) or ad group (ad_set_id), so ads stop showing for those searches. Returns { data: [{ id }] }. Google Ads only; other networks answer 501.
ads_negative_keywords_list
ChatGPTList negative keywords of a Google Ads campaign (campaign_id) or ad group (ad_set_id). Returns { data: [{ id, level, text, match_type, campaign_id, ad_set_id }] }. Google Ads only; other networks answer 501.
ads_search_terms_list
ChatGPTWhat people actually searched for before seeing a Google ad, with metrics: top 1000 by impressions. Returns { data: [{ term, status, campaign_id, ad_set_id, metrics }] }. Use it to find new keywords and negative keywords. Google Ads only; other networks answer 501.
ads_targeting_browse
ChatGPTThe network's full detailed-targeting catalog for an ad account, in the same row shape as ads_targeting_search. Large; prefer ads_targeting_search when you know what you are looking for. Meta only; Google Ads answers 501.
ads_targeting_search
ChatGPTLook up targeting options on the ad network and get the ids to use in targeting: interests, behaviors, languages, and location keys (the key of a region or city on Meta, a numeric location id on Google). Returns { data: [{ id, name, type, path, audience_size_lower, audience_size_upper, country_code, region, region_id }], next_page_token, cached }. Meta supports every type; Google only location and language.
ads_tree
ChatGPTCampaigns with their ad sets and ads nested (data[].ad_sets[].ads[]), from the last background sync. The quickest way to see an account's whole structure. Takes the list filters (applied to campaigns) plus depth. Paginated by campaign: { total, page, per_page, data }.
auth_status
ChatGPTCheck authentication status, API configuration, and workspace information
dm_chat_archive
ChatGPTArchive (mute) a chat. Bluesky only — calls Bluesky's muteConvo. Returns the chat with archived: true.
dm_chat_create
ChatGPTFind or create a chat for a participant on a DM-capable profile (idempotent — returns the existing chat if one already exists). Use before sending a message to a participant the profile has not yet messaged. On WhatsApp, placement_id (the phone number id from profiles_placements) is required and participant_external_id is the recipient's phone number in international format (digits only, no +); a new WhatsApp conversation must open with an approved template via dm_message_send.
dm_chat_get
ChatGPTGet a single chat by Postproxy hashid or by the platform's external_conversation_id.
dm_chat_mark_read
ChatGPTMark a chat as read. On WhatsApp this sends the read receipt (blue ticks) for the newest inbound message to the participant; on other networks it only stamps metadata.read_at locally. Returns the chat.
dm_chat_thread_control_pass
ChatGPTFacebook & Instagram only. Hand a conversation to another Meta app (Meta's handover protocol) — e.g. to a human in Meta's inbox: Page Inbox app 263902037430900, Instagram Inbox app 1217981644879628. Only works while Postproxy controls the conversation or it is idle. While another app controls a conversation, its messages still show up in the chat but dm_message_send is rejected until control comes back. Returns the chat; metadata.thread_control holds owner_app_id / expires_at.
dm_chat_thread_control_release
ChatGPTFacebook & Instagram only. Give up control of a conversation: it goes idle and the Page's default app answers the next message. Only the current owner can release. Returns the chat.
dm_chat_thread_control_request
ChatGPTFacebook, and Instagram connected via Facebook Login. Ask the app that currently controls the conversation to pass it to Postproxy. Nothing changes until that app does (check with dm_chat_thread_owner). Only works when the Page does NOT use Conversation Routing — the counterpart of dm_chat_thread_control_take. Returns the chat.
dm_chat_thread_control_take
ChatGPTFacebook, and Instagram connected via Facebook Login. Take a conversation back from whichever app holds it. Only works when the Page has Conversation Routing enabled and Postproxy is allowed to take control in its settings; otherwise Meta answers '(#27) Take thread control is not supported when Conversation Routing is not enabled' — use dm_chat_thread_control_request then. Returns the chat.
dm_chat_thread_owner
ChatGPTFacebook & Instagram only. Ask Meta which app controls a conversation right now, and refresh the chat's metadata.thread_control. Returns { app_id, expires_at }; both null when the conversation is idle. Page Inbox is app 263902037430900, Instagram Inbox 1217981644879628.
dm_chat_unarchive
ChatGPTUnarchive (unmute) a chat. Bluesky only — calls Bluesky's unmuteConvo. Returns the chat with archived: false.
dm_chats_list
ChatGPTList direct-message chats (conversations) for a DM-capable profile, ordered by most recent activity. Supported on Facebook (Messenger), Instagram, Telegram, Bluesky, and WhatsApp. WhatsApp chats carry external_placement_id (the phone number), group (true for group chats) and within_messaging_window.
dm_message_edit
ChatGPTEdit a previously-sent outbound message on the platform. Telegram only — Facebook and Instagram do not expose outbound edits, so Meta quick_replies and buttons cannot be changed after sending. Provide body (new text/caption) and/or reply_markup (pass {} to clear the keyboard); at least one is required.
dm_message_get
ChatGPTGet a single message by Postproxy hashid or by the platform's external_id. Outbound messages echo the quick_replies / buttons / card they were sent with; an inbound message created by a tap carries tapped_action: {kind, payload, title}.
dm_message_react
ChatGPTAdd a reaction from your business account to a message. Facebook Messenger, Instagram Direct and WhatsApp (not Telegram or Bluesky). On WhatsApp pass emoji — any unicode emoji — and reaction names are ignored. A second react replaces the previous one.
dm_message_send
ChatGPTSend an outbound direct message. Provide EXACTLY ONE of body (text), media (a single attachment), or — on WhatsApp — template, interactive, location or contacts. The message is queued and delivered asynchronously (returns status: pending). Outside Meta's 24h messaging window, a human agent replying to the participant's own inquiry can pass tag: HUMAN_AGENT (Facebook/Instagram only) — never for promotional or automated content. On WhatsApp the window is re-opened only by sending an approved template (or a text with category: utility); free-form sends outside it return 422. reply_markup is Telegram-only; reply_to_external_id works on Telegram and WhatsApp; quick_replies, buttons and card are the Facebook/Instagram interactive primitives and are rejected elsewhere — WhatsApp uses interactive (Meta-shaped) instead.
dm_message_unreact
ChatGPTRemove your business account's reaction from a message. Facebook Messenger, Instagram Direct and WhatsApp only.
dm_messages_list
ChatGPTList messages in a chat, most recent first. Optionally filter by direction or status. Inbound messages created by a tap on an interactive element you sent (quick reply, button postback, Instagram ice breaker, Telegram callback query) carry tapped_action: {kind, payload, title} — read the payload from there instead of digging through platform_data.
facebook_blocked_user_status
ChatGPTCheck whether one person is banned from a Facebook Page. Returns { blocked, user_id, name } (name is null when not blocked).
facebook_blocked_users_list
ChatGPTList people banned from a Facebook Page. Returns { blocked_users: [{ user_id, name }], next_cursor }; paginate with after = next_cursor (null on the last page).
facebook_page_get
ChatGPTRead a Facebook Page's profile fields — about, description, website, phone, emails, category, follower counts and other contact/company details. This is the Page itself, not posts published to it. Facebook omits fields the Page has never set. Uses Graph API field names.
facebook_reel_collaborators
ChatGPTInvite status of the Pages invited through a Facebook reel's collaborators parameter. Returns { post_id, collaborators: [{ name, invite_status (pending|accepted|declined), invitation_link }], fetched_at, cached }. Fetched from Facebook at most once every 5 seconds per reel. 422 if the post isn't a published Facebook reel on this profile.
facebook_users_block
ChatGPTBan up to 50 people from a Facebook Page: they can no longer comment, react, message or post to it. Bans are per Page. Identify people by Page-scoped user ID (a comment's author_external_id or a chat's participant_external_id). Returns { succeeded, failed, action }; IDs Facebook couldn't block are in failed with its reason.
facebook_users_unblock
ChatGPTLift Facebook Page bans for up to 50 people. Returns { succeeded, failed, action }.
google_business_attributes_available
ChatGPTList which attributes a location can actually set, with their value types. Valid attributes depend on the primary category and region, so ALWAYS call this before google_business_attributes_update. Two modes: by location (the default — omit region_code and language_code, Google takes them from the listing) or by category_name (then region_code is required).
google_business_attributes_get
ChatGPTRead the attributes currently set on a Google Business Profile location (payments, accessibility, service options, social links). Note Google omits the attributes key entirely when none are set rather than returning an empty array.
google_business_attributes_update
ChatGPTSet attributes on a Google Business Profile location. Value shape depends on the attribute's valueType from google_business_attributes_available: BOOL uses "values": [true], URL uses "uriValues": [{ "uri": "..." }], ENUM uses "repeatedEnumValue": { "setValues": ["TOKEN"] }. attribute_mask defaults to exactly the names you send, so untouched attributes are preserved.
google_business_categories_list
ChatGPTResolve Google business category resource names (e.g. 'categories/gcid:software_company') for a region. Category patches need these resource names, not display names, and the available set differs per country. Use filter to search by display name rather than paging thousands of results.
google_business_hours_update
ChatGPTSet opening hours on a Google Business Profile location. Times accept either "09:00"/"09:00:00" strings or Google's { hours, minutes } objects. Read current hours from google_business_location_get — each block you name in fields is replaced entirely.
google_business_location_get
ChatGPTRead a Google Business Profile location — name, description, website, phones, categories, address, hours, service area, service items, and metadata. This is the business listing itself, not posts published to it. Read this before any google_business_*_update: Google's updates are field-masked, so you patch back objects you fetched here.
google_business_location_update
ChatGPTUpdate fields on a Google Business Profile location. fields names exactly what you're replacing — anything named there but missing from the payload is CLEARED, and nested objects are replaced wholesale, not merged. Read with google_business_location_get first. Hours and the service list have their own tools.
google_business_media_create
ChatGPTAdd a photo or video to a Google Business Profile location. Google downloads the file from media_url itself — there is no upload step, so the URL must be publicly reachable https (not a short-lived signed URL, not localhost). Images need at least 250x250 and at most 5MB. Use category COVER or LOGO only when you intend to change the profile header or logo.
google_business_media_delete
ChatGPTPermanently remove a photo or video from a Google Business Profile location. media_name is the full resource name from google_business_media_list and must belong to this location.
google_business_media_list
ChatGPTList the photos and videos on a Google Business Profile location. These are profile photos, distinct from media attached to a local post.
google_business_place_action_link_create
ChatGPTAdd an action button to a Google Business Profile location. Which place_action_type values a location accepts varies by category. Google keys the link off (location, uri, placeActionType), so creating the same combination twice returns the existing link rather than a duplicate.
google_business_place_action_link_delete
ChatGPTRemove an action link from a Google Business Profile location. The button stops showing on Search and Maps.
google_business_place_action_link_update
ChatGPTUpdate an existing action link on a Google Business Profile location. name is the full resource path from google_business_place_action_links_list and must belong to this location.
google_business_place_action_links_list
ChatGPTList the action links on a Google Business Profile location — the 'Book online', 'Order online' and similar buttons. Google omits the placeActionLinks key entirely when there are none.
google_business_place_action_types_available
ChatGPTList the place_action_type values Google accepts for a Google Business Profile location. Depends on the location's categories and setup; check this first when google_business_place_action_link_create fails with 'Request contains an invalid argument'.
google_business_search_keywords
ChatGPTThe searches that showed a Google Business Profile location in Google Search and Maps, month by month. Returns { months: [{ month, keywords: [{ keyword, impressions, impressions_threshold }] }] }, keywords sorted by impressions, highest first. For low-volume keywords Google gives no exact count: impressions is null and impressions_threshold holds the upper bound. Range is at most 12 months; Google keeps keywords for the last 18 months only. A month with no data has an empty keywords array.
google_business_service_list_get
ChatGPTRead the services offered by a Google Business Profile location. Editable only when the location's metadata.canModifyServiceList is true.
google_business_service_list_update
ChatGPTReplace the service list on a Google Business Profile location. This is a full replacement, not a merge — send the complete list. Items are either { structuredServiceItem: { serviceTypeId } } using a serviceTypeId from the location's category, or { freeFormServiceItem: { category, label: { displayName, languageCode } } }. Fails with 422 when metadata.canModifyServiceList is false.
history_list
ChatGPTList recent post jobs. Each entry includes the full content, created_at, scheduled_at (null if not scheduled), draft flag, internal status, and the platforms the post targets with their status and published URLs
instagram_available_audio
ChatGPTSearch Meta's music and original-sound library for audio a reel can use as its soundtrack. Without search_query, returns trending audio. Items use Meta's field names: audio_id, audio_type, title, duration_in_ms, on_platform_audio_preview_link, download_url (temporary preview, expires in ~1.5 days); music items add display_artist and cover_artwork_thumbnail_uri, original sounds add ig_username and profile_picture_url. Pass the chosen audio_id to post_publish under platforms.instagram with format 'reel'. Only works for Instagram profiles connected through Facebook Login — Instagram Login profiles get 422 (reconnect with profile_groups_initialize_connection onboarding 'facebook'). Only audio authorized for third-party use is returned, so the catalog can differ from the Instagram app.
instagram_collaboration_invite_accept
ChatGPTAccept an incoming Instagram collaboration invite, making this profile a collaborator on the post. Returns { accepted: true, media_id }. Facebook Login profiles only.
instagram_collaboration_invite_decline
ChatGPTDecline an incoming Instagram collaboration invite. Returns { declined: true, media_id }. Facebook Login profiles only.
instagram_collaboration_invites_list
ChatGPTList incoming Instagram collaboration invites: posts from other accounts that invited this profile as a collaborator. Each invite has media_id, media_owner_username, caption and media_url (omitted for videos with copyrighted or licensed audio). Paginate with after = next_cursor (null on the last page). Accept or decline with instagram_collaboration_invite_accept / _decline. To send invites, pass collaborators to post_publish. Only works for Instagram profiles connected through Facebook Login — Instagram Login profiles get 422.
pinterest_board_create
ChatGPTCreate a board on a connected Pinterest account. Boards are the profile's placements: the new board appears in profiles_placements right away, and the returned id is the board_id post_publish takes under platforms.pinterest. Returns the placement { id, name, avatar_url, metadata }. Board names must be unique on the account (a duplicate returns 422).
pinterest_board_delete
ChatGPTDelete a Pinterest board. This ALSO DELETES EVERY PIN ON THE BOARD on Pinterest and cannot be undone — confirm with the user first. The board is removed from the profile's placements. Returns { deleted: true, board_id }.
post_delete
ChatGPTDelete a post from the database. By default does NOT remove from social media platforms. Pass delete_on_platform=true to also remove from all published platforms before DB deletion.
post_delete_on_platform
ChatGPTDelete a published post from social media platforms WITHOUT removing it from the database. Async via background job. Optionally narrow scope by post_profile_id (covers entire thread for that profile), profile_id, or network. With no scope, deletes from all published platforms. Supported: Facebook, Threads, X (Twitter), LinkedIn, Pinterest, YouTube. NOT supported: Instagram, TikTok.
post_publish
ChatGPTPublish a post to specified social media profiles. Supports text content, media attachments, scheduling, drafts, threads (X and Threads only), and platform-specific customization via the 'platforms' parameter.
post_publish_draft
ChatGPTPublish a draft post. Only posts with draft status can be published using this endpoint
post_stats
ChatGPTGet stats snapshots for one or more posts. Returns all matching snapshots so you can see trends over time. Supports filtering by profiles/networks and timespan.
post_status
ChatGPTGet status of a post by post ID. Returns the full content, scheduled_at (null if not scheduled), created_at, draft flag, internal status, per-platform status with published URLs, and media details
post_update
ChatGPTUpdate an existing post. Only drafts or scheduled posts (more than 5 min before publish) can be updated. Only send fields you want to change — omitted fields are left unchanged.
profile_groups_initialize_connection
ChatGPTGenerate a URL to connect a new social media profile to a profile group (initiates the OAuth/connect flow). The returned URL should be opened by the user to complete the connection. For whatsapp, optionally pass onboarding ('api' or 'business_app'); when omitted the connect page asks the user where their number lives. For instagram, optionally pass onboarding 'facebook' to connect through Facebook Login (an Instagram professional account linked to a Facebook Page the user manages) instead of the default Instagram Login. Bluesky and Telegram need credentials, so they are connected in the Postproxy web app rather than here.
profile_groups_list
ChatGPTList all profile groups accessible with your API key. Profile groups are organizational containers (e.g. per brand or client) that hold related social media profiles. Use the returned group id to filter profiles_list by profile_group_id.
profiles_list
ChatGPTList all available social media profiles for posting. Optionally filter by profile_group_id.
profiles_placements
ChatGPTList available placements for a profile. For Facebook: business pages. For LinkedIn: personal profile and organizations. For Pinterest: boards. For Telegram: channels the bot can post to. For Google Business: locations (returned as full resource paths 'accounts/X/locations/Y' to pass as location_id). For WhatsApp: the phone numbers on the Business Account — the placement id is the phone_number_id every whatsapp_* tool and dm_chat_create take, and metadata carries display_phone_number, quality_rating, messaging_limit_tier, name_status, platform_type. Available for facebook, linkedin, pinterest, telegram, google_business and whatsapp profiles.
profiles_stats
ChatGPTGet the follower/engagement timeseries for a profile. Returns daily snapshots (captured every ~23h). placement_id is required for facebook, linkedin, telegram, and google_business profiles (get it from profiles_placements); omit for other networks. Fields in records[].stats are platform-native and not normalized. For google_business the series is per location: impressions, website clicks, call clicks, direction requests and conversations — there is no follower count.
queues_create
ChatGPTCreate a new posting queue with weekly timeslots. Use profiles.list to find the profile_group_id.
queues_delete
ChatGPTDelete a posting queue. Posts in the queue will have their queue reference removed but will not be deleted.
queues_get
ChatGPTGet details of a single posting queue including its timeslots and post count
queues_list
ChatGPTList all posting queues. Queues automatically schedule posts into recurring weekly timeslots with priority-based ordering.
queues_next_slot
ChatGPTGet the next available timeslot for a queue
queues_update
ChatGPTUpdate a queue's settings, timeslots, or pause/unpause it. Changes to timezone or timeslots trigger rearrangement of all queued posts.
summary_get
ChatGPTAnswer "what's the status?" in one call. Returns an activity snapshot for a time window: posts published and failed (plus what's scheduled next), engagement totals summed from each post's latest stats snapshot, comments and reviews received, and DM volume — each broken down per network. Also returns what's still waiting on you: comments and reviews with no reply from you, and DM chats whose newest message is inbound (with how many are about to run out of their 24h messaging window). Prefer this over calling history_list / comments_list / dm_chats_list separately. Two quirks worth knowing: engagement is lifetime-to-date for posts published in the window rather than engagement earned during it, and the awaiting_reply counts describe current state so they don't change with the window (they look back 30 days, returned as window.backlog_from). Post counts are posts — a post sent to three networks counts once — while by_platform counts per-network deliveries. engagement is null when insights are off for the account, dms when DMs are.
tiktok_trending_music
ChatGPTList up to 100 trending tracks from TikTok's Commercial Music Library (not paginated; TikTok's field names). To attach one when publishing, pass a song_clip_id — from trending_song_clip (the short popular part) or full_duration_song_clip (whole track) — as platforms.tiktok.audio_id in post_publish. Durations are in seconds. Only for TikTok profiles connected on or after 2026-09-30 (Business API); older connections get 422 until reconnected.
upload_create
ChatGPTCreate a temporary file upload URL for sandboxed environments. Returns a key, an upload_url, and expires_in (seconds). Flow: (1) call this tool, (2) POST the raw file bytes to the returned upload_url (valid for expires_in seconds), which responds with {"url": "https://..."}, (3) pass that returned url in the media array of post_publish (or post_update). The upload host is tmpfiles.postproxy.dev — that domain must be whitelisted/allowlisted in the sandbox's network egress rules for the upload to succeed. Only use this when running against the remote (hosted) MCP server: if you are running the local (stdio) MCP server, do NOT use this — instead pass local file paths directly in the media array, which uploads them via multipart.
whatsapp_blocked_user_status
ChatGPTCheck whether one phone number is currently blocked on a WhatsApp phone number.
whatsapp_blocked_users_list
ChatGPTList the phone numbers (wa_id) blocked on a WhatsApp phone number, paginated with limit / after (next_cursor in the response).
whatsapp_business_profile_get
ChatGPTRead the public business profile shown in WhatsApp for a phone number: about, address, description, email, websites, vertical and profile_picture_url.
whatsapp_business_profile_photo_update
ChatGPTReplace the profile photo of a phone number. Pass either url (a public https image) or data (base64, with content_type). JPEG or PNG, at most 5MB.
whatsapp_business_profile_update
ChatGPTUpdate the public business profile of a phone number. Send only the fields to change; at least one is required. about max 139 chars, description max 512, websites at most 2 entries. The profile photo has its own tool.
whatsapp_conversion_event_send
ChatGPTReport a conversion (LeadSubmitted, Purchase, AddToCart, InitiateCheckout, ViewContent) for a conversation that started from a Click-to-WhatsApp ad, so Meta can attribute it. Identify the conversation by chat_id or phone; it must carry a captured ctwa_clid (422 otherwise). event_id must be unique per event. email and external_id are SHA-256 hashed before sending. Pass test_code to route the event to Meta's test-events view.
whatsapp_dataset_create
ChatGPTCreate a Conversions API dataset on the WhatsApp Business Account so Click-to-WhatsApp ad conversions can be reported. Idempotent: returns the existing dataset with created: false.
whatsapp_dataset_get
ChatGPTRead the Conversions API dataset id attached to the WhatsApp Business Account (null when none). Needed for whatsapp_conversion_event_send.
whatsapp_display_name_get
ChatGPTRead the verified display name of a phone number and its review status (name_status), plus any pending new_name_status.
whatsapp_display_name_request_change
ChatGPTSubmit a new display name for Meta review. The current name stays until Meta approves; the outcome arrives on the placement.name_status_updated webhook.
whatsapp_group_create
ChatGPTCreate a WhatsApp group administered by the phone number. Returns the group id and invite_link. Add members with whatsapp_group_participants_add or share the invite link.
whatsapp_group_delete
ChatGPTDelete a WhatsApp group the phone number administers.
whatsapp_group_get
ChatGPTRead a WhatsApp group: subject, description, join_approval_mode, invite_link, participants, participant_count, created_at, is_suspended.
whatsapp_group_invite_link_create
ChatGPTGenerate a fresh invite link for a WhatsApp group (revokes the previous one).
whatsapp_group_join_requests_approve
ChatGPTApprove pending join requests for the given phone numbers.
whatsapp_group_join_requests_list
ChatGPTList pending join requests on a WhatsApp group with join_approval_mode approval_required.
whatsapp_group_join_requests_reject
ChatGPTReject pending join requests for the given phone numbers.
whatsapp_group_participants_add
ChatGPTAdd up to 8 phone numbers to a WhatsApp group (a group holds 8 participants).
whatsapp_group_participants_remove
ChatGPTRemove phone numbers from a WhatsApp group.
whatsapp_group_update
ChatGPTChange a WhatsApp group's subject, description and/or join_approval_mode. At least one is required.
whatsapp_groups_list
ChatGPTList the WhatsApp groups a phone number administers (Groups API — Cloud API numbers only; coexistence numbers can't use it). Paginated with limit / after.
whatsapp_number_info
ChatGPTRead the live state of a WhatsApp phone number from Meta: display_phone_number, verified_name, name_status, quality_rating, messaging_limit_tier, throughput, status, platform_type (CLOUD_API vs a coexistence number still in the WhatsApp Business app), plus the Business Account's review and verification status.
whatsapp_template_create
ChatGPTSubmit a new WhatsApp message template to Meta for review. Either pass components (custom template: HEADER / BODY / FOOTER / BUTTONS in Meta's shape, with example values for any {{n}} placeholders) or library_template_name to instantiate one of Meta's pre-approved library templates (approved instantly). name must be lowercase letters, digits and underscores; category is UTILITY, MARKETING or AUTHENTICATION. Custom templates come back PENDING — watch the message_template.status_updated webhook or re-list with refresh.
whatsapp_template_delete
ChatGPTDelete a WhatsApp template on Meta and in Postproxy. With language, only that language variant is deleted; addressing by name without language deletes every language of that name. Deleted template names can't be reused for 30 days on Meta.
whatsapp_template_get
ChatGPTGet one WhatsApp message template with its components (header, body, footer, buttons), status, category, parameter_format and variable_count.
whatsapp_template_library_get
ChatGPTLook up a pre-approved template in Meta's template library by name (e.g. order_confirmation, delivery_update) to see the inputs it needs before creating it with whatsapp_template_create + library_template_name.
whatsapp_template_update
ChatGPTUpdate a WhatsApp template's components and/or message_send_ttl_seconds. Editing components sends the template back through Meta review (status returns to PENDING). At least one of components / message_send_ttl_seconds is required.
whatsapp_templates_list
ChatGPTList the message templates on a WhatsApp Business Account (the profile) as Postproxy has them synced from Meta. Filter by name, language or status (APPROVED, PENDING, REJECTED, PAUSED, DISABLED). Pass refresh: true to pull Meta's current list first. Only APPROVED templates can be sent; each entry's variable_count is how many values dm_message_send's template.variables must carry.
whatsapp_username_delete
ChatGPTRelease the WhatsApp username set on a phone number.
whatsapp_username_get
ChatGPTRead the WhatsApp username (wa.me/username handle) set on a phone number, if any, and its status.
whatsapp_username_set
ChatGPTClaim or change the WhatsApp username of a phone number. Letters, digits, periods and underscores, must contain a letter, no leading / trailing / consecutive periods. Pass transfer_action: force_transfer to move a username already held by another number in the same business.
whatsapp_username_suggestions
ChatGPTGet Meta's available username suggestions for a phone number.
whatsapp_users_block
ChatGPTBlock up to 1000 phone numbers on a WhatsApp phone number so they can no longer message it. Returns succeeded and failed lists.
whatsapp_users_unblock
ChatGPTUnblock up to 1000 previously blocked phone numbers on a WhatsApp phone number. Returns succeeded and failed lists.
youtube_playlist_create
ChatGPTCreate a playlist on a connected YouTube channel. Returns the new playlist. Costs 50 units of the channel's YouTube Data API quota.
youtube_playlist_delete
ChatGPTDelete a playlist from a connected YouTube channel. The videos in it are NOT deleted. Cannot be undone. Returns { deleted: true, playlist_id }. Costs 50 quota units.
youtube_playlist_update
ChatGPTUpdate a playlist on a connected YouTube channel. Fields you leave out keep their current value. Returns the updated playlist. Costs 50 quota units.
youtube_playlists_list
ChatGPTList the playlists on a connected YouTube channel, up to 50 per page. Each playlist has id, title, description, privacy_status (public|unlisted|private), item_count, thumbnail_url and published_at. A playlist's id is the playlist_id post_publish takes under platforms.youtube to add the uploaded video to it. Paginate with page_token = next_page_token (null on the last page).
auth_status
Claudedm_chat_archive
Claudedm_chat_create
Claudedm_chat_get
Claudedm_chat_unarchive
Claudedm_chats_list
Claudedm_message_edit
Claudedm_message_get
Claudedm_message_react
Claudedm_message_send
Claudedm_message_unreact
Claudedm_messages_list
Claudehistory_list
Claudepost_delete
Claudepost_delete_on_platform
Claudepost_publish
Claudepost_publish_draft
Claudepost_stats
Claudepost_status
Claudepost_update
Claudeprofile_groups_initialize_connection
Claudeprofile_groups_list
Claudeprofiles_list
Claudeprofiles_placements
Claudeprofiles_stats
Claudequeues_create
Claudequeues_delete
Claudequeues_get
Claudequeues_list
Claudequeues_next_slot
Claudequeues_update
Claudeupload_create
Claude