accounts_list
ChatGPTList connected ad accounts across all providers (or one provider).
apple_adgroups
ChatGPTRead Apple adgroups, including all returned targeting, bids, match types, statuses and creative destinations. Use resource_id for a single record, or filters and offset for paginated queries.
apple_ads
ChatGPTRead Apple ads, including all returned targeting, bids, match types, statuses and creative destinations. Use resource_id for a single record, or filters and offset for paginated queries.
apple_app_eligibility
ChatGPTCheck eligibility for an App Store app by placement, country and device before campaign creation. Returns actual ELIGIBLE/INELIGIBLE rows and minimum age.
apple_apply_recommendations
ChatGPTApply Apple Ads v1 daily-budget or target-CPA recommendations. The provider re-queries every recommendation and policy-checks the current and proposed Money values before apply. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_assets
ChatGPTRead Apple assets with native fields and pagination. Availability depends on account role, promoted object and regional eligibility.
apple_business_brands
ChatGPTRead Apple business-brands with native fields and pagination. Availability depends on account role, promoted object and regional eligibility.
apple_campaigns
ChatGPTList Apple Ads Platform API v1 campaigns for an ad account.
apple_change_history
ChatGPTRead Apple audit summaries for explicit entity types in a UTC event-time range. Native user, transaction and entity metadata are preserved.
apple_create_ad
ChatGPTCreate a PAUSED ad linked to an existing VALID creative (including a custom product page). Does not enable the campaign. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_create_ad_group
ChatGPTCreate an Apple Ads Platform API v1 App Store ad group using CPT pricing and a MANUAL_CPT/TAP bid strategy. The typed tool emits the documented bidStrategy.bid Money shape. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_create_brand_ad_group
ChatGPTCreate a Maps ad group with validated location groups. Inherits campaign bidding/pricing; manual bidding requires bid in whole account-currency units. Policy may force PAUSED. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_create_brand_campaign
ChatGPTCreate a Maps campaign for an accessible Business Brand. Requires Apple Business Brand permissions. Choose MAX_ENGAGEMENTS, MANUAL_CPT or MANUAL_CPM; policy may force PAUSED. Omit placement for both Maps placements. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_create_brand_creative
ChatGPTCreate a Maps logo/asset creative from account-accessible brand assets and localized promo copy. Destination is the Maps place card. Wait for VALID before linking an ad. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_create_campaign
ChatGPTCreate an Apple Ads Platform API v1 App Store campaign (search results, TAPS billing). daily_budget is a float in whole currency units; adam_id is the App Store app id. Apple has no dry run — previews are client-side diffs. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_create_creative
ChatGPTCreate a default or custom product page creative. Default creatives are unique per app/account; reuse an existing apple_creatives ID. Copy and visuals come from App Store Connect. Use apple_product_pages for a custom product_page_id. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_create_keyword
ChatGPTCreate a documented Apple Ads Platform API v1 keyword. Omit bid and currency together to inherit the ad-group bid. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_create_keywords
ChatGPTCreate up to 100 keywords in one preview/apply pair. Inherit the ad-group bid by omitting bid and currency. The batch disallows partial success; created keywords default to PAUSED. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_create_location_group
ChatGPTCreate a STATIC location-ID group or a DYNAMIC rule group for an accessible brand. Dynamic groups can remain PENDING until Apple finishes evaluation. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_create_negative_keywords
ChatGPTAdd campaign OR ad-group negative keywords in one preview/apply pair. Exclusions are ENABLED to prevent matching; this does not enable campaigns or ads. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_creatives
ChatGPTRead Apple creatives, including all returned targeting, bids, match types, statuses and creative destinations. Use resource_id for a single record, or filters and offset for paginated queries.
apple_delete_resource
ChatGPTPermanently delete an account-owned campaign, ad group, ad, creative, keyword, negative keyword, asset or location group. Apple does not allow deleting default product-page creatives. Deletion may affect dependent resources. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_dismiss_recommendations
ChatGPTDismiss Apple Ads v1 daily-budget or target-CPA recommendations through the normal preview/apply gate. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_impression_share
ChatGPTRead native App Store impression-share insights for an app. DAILY or WEEKLY_SUN_SAT UTC periods; no synthetic percentage is inferred for suppressed results.
apple_keywords
ChatGPTRead Apple keywords, including all returned targeting, bids, match types, statuses and creative destinations. Use resource_id for a single record, or filters and offset for paginated queries.
apple_location_groups
ChatGPTRead Apple location-groups with native fields and pagination. Availability depends on account role, promoted object and regional eligibility.
apple_locations
ChatGPTRead Apple locations with native fields and pagination. Availability depends on account role, promoted object and regional eligibility.
apple_negative_keywords
ChatGPTRead Apple negative-keywords, including all returned targeting, bids, match types, statuses and creative destinations. Use resource_id for a single record, or filters and offset for paginated queries.
apple_product_pages
ChatGPTRead Apple product-pages, including all returned targeting, bids, match types, statuses and creative destinations. Use resource_id for a single record, or filters and offset for paginated queries.
apple_recommendations
ChatGPTQuery Apple recommendations for an explicit promoted app or business brand. Returns native recommendation IDs and values; querying never applies or dismisses them.
apple_report
ChatGPTRead native App Store campaign, ad-group, ad, keyword or search-term metrics, metadata and breakdowns. Preserves granular rows and pagination. Search terms use account time (ORTZ). Revenue is unavailable.
apple_search_apps
ChatGPTFind owned or advertised App Store apps, or search by name/ID and storefront. Returns Apple metadata and eligibility without changing account access.
apple_search_geo
ChatGPTDiscover Apple targeting location IDs and eligibility. Supply source selects App Store or Maps; returned eligibility must be checked before targeting.
apple_search_suggestions
ChatGPTLook up phrase or category popularity using exact terms or a partial search. Uses the SEARCH route, without requiring access to a promoted app or brand.
apple_search_term_popularity
ChatGPTRead native App Store search-term popularity for complete UTC weekly or monthly periods. Filters and provider suppression remain visible.
apple_set_ad_group_status
ChatGPTEnable or pause an existing Apple Ads ad group. Parent campaign and ad-group statuses remain independent. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_set_ad_status
ChatGPTEnable or pause an existing Apple Ads ad. Parent campaign and ad-group statuses remain independent. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_set_bid
ChatGPTChange a v1 campaign, ad-group, or keyword bid after fetching the current Money value for policy enforcement. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_set_budget
ChatGPTChange an Apple Ads campaign's daily budget (float, whole currency units). Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_set_campaign_schedule
ChatGPTEdit campaign start/end dates in UTC without changing serving status. Omitted fields remain unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_set_campaign_status
ChatGPTEnable or pause an Apple Ads campaign. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_set_keyword_status
ChatGPTEnable or pause an existing Apple Ads keyword. Parent campaign and ad-group statuses remain independent. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_set_search_match
ChatGPTEnable or disable automated keyword matching for an account-owned ad group. Campaign, ad-group and keyword statuses remain unchanged; automatedKeywordsRequired can prevent disabling. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_set_shared_budget
ChatGPTChange an Apple Ads v1 shared-budget value after fetching its current Money value. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_shared_budgets
ChatGPTRead Apple shared-budgets with native fields and pagination. Availability depends on account role, promoted object and regional eligibility.
apple_suggestions
ChatGPTQuery Apple suggestions for an explicit promoted app or business brand. Returns native recommendation IDs and values; querying never applies or dismisses them.
apple_supported_languages
ChatGPTQuery Apple supported app languages and locale metadata; filters include countryCode and name.
apple_update_ad
ChatGPTRename an account-owned Apple ad. Creative association and status remain unchanged; create another paused ad to use a different creative. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_update_brand_creative_copy
ChatGPTEdit one existing locale of Maps promotional text, preserving other locales, assets and format. Changes affect ads sharing this creative and may require review. App Store copy is managed in App Store Connect. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_update_creative
ChatGPTRename an Apple creative or replace its complete creativeSpec using the native format. Content edits may affect every ad sharing this creative and require Apple review. Destination and creative type cannot be changed. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_update_location_group
ChatGPTRename a location group or replace its membership/rules within its current STATIC/DYNAMIC type. Omitted fields remain unchanged. Membership edits affect ad groups using this group. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_update_targeting
ChatGPTEdit only supplied campaign or ad-group targeting dimensions. A supplied dimension replaces its include/exclude lists; null clears that dimension. Omitted dimensions and serving status remain unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
apple_upload_asset
ChatGPTUpload a PNG, JPG/JPEG, or HEIC creative asset for a Business Brand. SHA-256 binds exact bytes to approval. Hosted calls require a project media_id; file_path is local-only. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
audit_preview
ChatGPTEvaluate the cross-platform audit rule packs over connected accounts and return structured findings without persisting them. Use this read-only audit in Reader workspaces or for one-off analysis.
audit_run
ChatGPTRun the cross-platform audit rule packs over connected accounts (campaign level). Persists structured findings for recommendation lifecycle management; some carry a ready-to-apply proposed action.
capabilities_list
ChatGPTLook up availability and access requirements for named Adport tools. Returns connection settings and status; this lookup changes no settings and executes no operations.
google_add_asset_group_signals
ChatGPTAdd account-owned audience references or search themes with expected_signals_hash. These guide optimization rather than restrict targeting. No records are uploaded, audiences created or serving statuses changed. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_add_experiment_arms
ChatGPTAdd generated treatment draft arms to SETUP and atomically rebalance supplied existing arm shares. Final traffic totals 100. New draft copies are checked/paused under policy, with explicit deferred validation and budget bounds. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_add_keywords
ChatGPTAdd keywords (or negative keywords) to an ad group. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
google_ads
ChatGPTBrowse Google Ads with their actual text, final URLs, serving status and creative actions. Filter by campaign or ad group. Changes requested from the creative viewer return a preview before approval.
google_asset_group_context
ChatGPTRead one owned group, complete scoped creative/brand associations, signals and listing filters with separate group/assets/signals/listing snapshot hashes. Includes draft groups. Fails if a complete context exceeds its bounded read.
google_asset_group_creatives
ChatGPTView actual Performance Max group copy, owned image previews and landing URLs, with guarded status/copy-edit actions. The group generates creative combinations; it is not one fixed rendered ad. Previews omit unsupported media origins.
google_asset_groups
ChatGPTList owned Performance Max asset groups in one campaign with status, actual landing URLs and native eligibility/ad-strength reasons. Continue next_cursor as after_asset_group_id; use context/creatives for one group.
google_asset_links
ChatGPTRead shared asset associations for one customer, campaign or ad group. Removed associations are excluded; native field types and statuses are preserved.
google_assets
ChatGPTView account-owned shared assets, extension copy, image previews and native policy status. Continue with next_cursor as after_asset_id and the same filters. Assets cannot be deleted; remove serving associations instead. Name edits use the normal preview/apply gate.
google_campaign_targeting
ChatGPTRead scoped campaign location/language/device/schedule configuration and snapshot_hash. Native statuses, omitted bid multipliers and retained radius/group references remain explicit. Stable snapshot paging supports Load more. Search language criteria are legacy, not serving restrictions.
google_conversion_actions
ChatGPTList native conversion configuration available in the selected customer, including owner, type, status, goals, attribution, value settings and tag snippets. Continue next_cursor as after_action_id.
google_conversion_request_status
ChatGPTRead Data Manager processing status and error/warning counts using the signed receipt from this account’s approved ingestion. Native request IDs alone do not authorize this account-less endpoint. Wait about 30 minutes after acceptance; do not resubmit a processing batch.
google_conversion_tracking_context
ChatGPTRead the selected customer conversion tracking owner, currency, tracking status and customer-data terms flags. Returns snapshot_hash for configuration creation; never accepts terms or changes tracking ownership.
google_create_ad_group
ChatGPTCreate a SEARCH_STANDARD ad group in a campaign. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
google_create_asset_group
ChatGPTCreate a complete owned-campaign Performance Max group with atomic creative links, optional audience/search-theme signals and a retail product tree. Requires expected_campaign_hash. New group obeys paused policy; enabled child links cannot serve inside a paused group. Brand-guidelines campaigns need existing campaign-level branding. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_create_campaign
ChatGPTCreate a campaign and non-shared budget atomically, with bidding and optional location/language targeting. Search defaults to Google Search only (no partners or Display expansion). Use google_gaql to resolve geo_target_constant and language_constant IDs. Ad groups, keywords and responsive search ads have separate explicit tools. Creation remains subject to paused-creation policy. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
google_create_conversion_action
ChatGPTCreate an UPLOAD_CLICKS, UPLOAD_CALLS or WEBPAGE conversion configuration using expected_context_hash from tracking context. Explicit category/counting mode; secondary by default. Native validate_only preview; no events sent or tags installed. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_create_experiment
ChatGPTCreate an unscheduled system-managed experiment with control/treatment arms in one native atomic request. Native draft copies are verified and paused by policy before success; no base pause, scheduling or serving. Requires expected_base_hash. Budget bounds use micros. Deferred draft pausing is reported as not fully server-validated. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_create_extension_asset
ChatGPTCreate an unattached sitelink, callout or structured-snippet asset with native server validation. Does not attach it to serving entities. Assets cannot be deleted. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_create_label
ChatGPTCreate unattached label metadata with native validate_only preview. Name 1–80 characters; optional hex background color and description up to 200 characters. No serving or budget change. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_create_performance_max_campaign
ChatGPTCreate a Performance Max campaign in an authorized Google Ads account with a dedicated budget and one asset group. Checks existing assets in that account and sends one atomic request after approval. The preview uses Google Ads validateOnly. Workspace policy may require paused creation; final URL expansion defaults off. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_create_responsive_search_ad
ChatGPTCreate a responsive search ad (3–15 headlines ≤30 chars, 2–4 descriptions ≤90 chars). Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
google_create_text_asset
ChatGPTCreate immutable unattached text for headlines, descriptions or business name. Link separately to an eligible placement; Google validates its language-aware length rules on association. No serving change; assets cannot be deleted. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_create_youtube_asset
ChatGPTReference an existing YouTube video ID as an unattached Google asset. Does not upload or publish a video or attach it to an ad. Assets cannot be deleted. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_data_manager_context
ChatGPTRead the verified conversion owner, configured login account and existing OAuth Data Manager scope status. Does not change grants, enable APIs, accept terms or upload events.
google_end_experiment
ChatGPTImmediately end the verified experiment through native EndExperiment, with validateOnly preview. Treatment campaigns stop serving but are retained; no campaign is promoted or graduated. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_experiment_async_errors
ChatGPTRead the selected experiment’s native scheduling/promotion errors. Returns enum/field diagnostics without sensitive native value echoes; continue next_page_token with identical selection.
google_experiment_context
ChatGPTRead experiment/arms and their scoped base/draft/trial campaigns, daily budgets, currency/timezone and snapshot hashes. Supply base_campaign_id before create, experiment_id before edits/actions, and campaign_budget_id for graduation. Hashes cover returned configuration, not every underlying ad/keyword/target.
google_experiment_operation
ChatGPTRead only the current account-scoped operation named by this verified experiment. Distinguishes PROCESSING, SUCCEEDED, FAILED and UNKNOWN; no scheduling, cancellation or retry.
google_experiments
ChatGPTList account-owned experiment configuration, lifecycle and latest operation. Continue next_cursor as after_experiment_id. No campaigns are created or scheduled.
google_field_metadata
ChatGPTLook up up to 20 exact GAQL resource or field names in the connected API version. Returns native types, enums and queryability; optional compatibility lists can be large. API-wide metadata, not account performance. Continue next_page_token with identical names/options.
google_gaql
ChatGPTRun a structured Google Ads (GAQL) query: pick a resource (campaign, ad_group, keyword_view, change_event, ...), fields (e.g. campaign.name, metrics.clicks, segments.date), optional conditions and ordering. Conditions are raw GAQL predicates, e.g. "segments.date DURING LAST_7_DAYS" or "campaign.status = 'ENABLED'".
google_get_conversion_action
ChatGPTRead one available action and snapshot_hash, bound to its native owner and selected-customer tracking context. Shared/system-owned actions remain read-only. Tag snippets are returned as text and never installed.
google_graduate_experiment
ChatGPTGraduate one verified treatment campaign to an independent campaign using an owned, unused non-shared daily budget. Requires current experiment/budget hashes and explicit serving confirmation; reports the budget delta in micros. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_ingest_conversion_events
ChatGPTIngest 1–2000 offline UPLOAD_CLICKS or multi-source WEBPAGE conversion events with Data Manager v1. Requires its separate OAuth scope/API enablement and an action snapshot. Native validateOnly preview; apply returns asynchronous acceptance and an account-bound status receipt. Hashed user data is HEX with explicit consent. No automatic retry. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_keyword_historical_metrics
ChatGPTRead native historical search volume, competition and bid estimates for up to 10,000 keywords. Google merges close variants; missing values stay unavailable and monetary int64 values remain native micros strings. Does not create a keyword plan or campaign.
google_keyword_ideas
ChatGPTDiscover keyword ideas from keywords, a URL, both, or a site. Reads one native page; pass next_page_token as page_token with identical targeting and seed. Metrics are historical estimates, not a forecast. No keyword plan or campaign is created.
google_label_associations
ChatGPTRead label assignments for an owned campaign, ad group, ad or criterion after checking the full account/parent hierarchy. Reports truncation; manager-to-customer labels are separate.
google_label_context
ChatGPTRead one enabled owned label and its metadata snapshot_hash. Supply that value as expected_label_hash for edits, removal or associations; association inventory is not included.
google_labels
ChatGPTRead enabled account-owned label metadata in native ID order. Continue next_cursor as after_label_id. Labels owned by managers are separate.
google_link_asset
ChatGPTAttach an account-owned extension/image/branding asset to a customer, campaign or ad group. Defaults paused; paused-creation policy is reported. Native validation checks placement eligibility. Does not create an ad or change parents. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_link_label
ChatGPTAssign a current owned label to a verified campaign, ad group, ad or criterion. Classification can affect reports and automation; serving statuses and budgets are preserved. Rejects existing assignments. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_performance_max_context
ChatGPTRead an owned Performance Max campaign, budget, brand-guidelines state, automation settings and campaign brand links. Supply campaign_snapshot_hash to guarded group/brand changes. Does not enable a campaign or access Merchant Center records.
google_promote_experiment
ChatGPTApply the current treatment configuration to its base through native promotion. Explicit serving confirmation and expected_experiment_hash required. Preview includes conservative daily budget ceilings; async submission is separate from completion. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_remove_asset_group
ChatGPTRemove a verified asset group and its native child associations/signals/filter tree, using expected_group_hash. Parent campaign, budget and shared source assets are retained. Native constraints still apply. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_remove_asset_group_signals
ChatGPTRemove exact owned signal IDs from the selected group with expected_signals_hash. Does not delete audiences or upload customer records. Native minimum-signal rules remain authoritative. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_remove_conversion_action
ChatGPTRemove an owned conversion action with expected_action_hash. Recording, reports and goals using the action can be affected. Native validate_only preview; no conversion events are submitted. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_remove_experiment
ChatGPTRemove the verified experiment through native mutate. Preview lists associated arms/campaign copies; native type/state constraints and protected-account policy still apply. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_remove_experiment_arms
ChatGPTRemove owned SETUP arms and atomically rebalance remaining traffic. Native removal may delete their draft copies. Control campaigns are retained; removing the control requires removing the full arm set. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_remove_keywords
ChatGPTPERMANENTLY remove keyword criteria from an ad group. Prefer google_set_keyword_status to pause. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
google_remove_label
ChatGPTRemove an owned label and its assignments after matching its metadata snapshot. Affects all uses, including active entities and label-based reports or automation. Does not delete labeled entities. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_rename_asset
ChatGPTChange only an account-owned shared asset name. Content and serving associations remain unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_replace_asset_group_listing_filters
ChatGPTReplace a retail SHOPPING product tree atomically with expected_listing_hash. Typed brand/category/product type/custom-label/item/channel/condition nodes require unique keys, one root and complete subdivisions. Old children are removed first; new parents created first. Can alter eligible products in serving groups; feeds/status/budgets are retained. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_schedule_experiment
ChatGPTMaterialize and schedule a SETUP experiment with explicit serving confirmation and expected_experiment_hash. Native action can start serving campaigns and has no paused-creation flag, so paused_creation blocks it. Otherwise native validateOnly previews, then apply returns an asynchronous operation. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_set_ad_group_status
ChatGPTEnable or pause an ad group. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
google_set_ad_status
ChatGPTEnable or pause an existing ad in its ad group. Enabling an ad does not change its campaign or ad-group status. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_set_asset_group_status
ChatGPTEnable or pause a verified owned asset group with expected_group_hash. Enabling can serve its generated combinations if the parent campaign is enabled. Does not change campaign status or budget. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_set_asset_link_status
ChatGPTEnable or pause an existing owned asset association. Enabling can change active ads that use this association; parent statuses are unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_set_bid_ceiling
ChatGPTSet a campaign's max CPC bid ceiling (micros). Works for MAXIMIZE_CLICKS (target spend) and TARGET_IMPRESSION_SHARE strategies; fails with guidance for others. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
google_set_bidding_strategy
ChatGPTSwitch a campaign's bidding strategy: MANUAL_CPC, MAXIMIZE_CLICKS (optional cpc_bid_ceiling_micros), MAXIMIZE_CONVERSIONS (optional target_cpa_micros), MAXIMIZE_CONVERSION_VALUE (optional target_roas). Also updates the target of the current strategy when the strategy stays the same. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
google_set_budget
ChatGPTChange a campaign's daily budget. The preview warns when the budget is shared across campaigns. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
google_set_campaign_status
ChatGPTEnable or pause a campaign. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
google_set_conversion_action_status
ChatGPTEnable or remove an owned conversion action with expected_action_hash. REMOVED uses the native remove operation and can affect goals; re-enablement uses native ENABLED subject to type restrictions. HIDDEN is readable but excluded from writes after a live native denial. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_set_keyword_status
ChatGPTEnable or pause a keyword criterion. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
google_unlink_asset
ChatGPTRemove one exact asset association, preserving the asset itself. Changes every serving use of this association. Native server validation runs before approval. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_unlink_label
ChatGPTRemove one exact owned label assignment, preserving the shared label and labeled entity. Requires current label metadata hash. Native validate_only runs before approval. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_update_asset_group
ChatGPTEdit only supplied group name, URLs, display paths and tracking fields with exact masks and expected_group_hash. Omission preserves values. Existing statuses, creative sources, campaign budget and parent are retained. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_update_asset_group_assets
ChatGPTAtomically add supplied creative placements/text assets and remove exact owned associations, using expected_assets_hash. Preserves source assets and parent/group status. New links are enabled as an explicit creative edit; serving combinations can change. Final set must meet native minimums; retail can unlink all custom assets to return to feed-only. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_update_asset_group_copy
ChatGPTReplace supplied headline/long-headline/description sets atomically with expected_assets_hash. Retains matching existing text and all unsupplied placements. New immutable text assets precede consecutive association changes; shared old sources are retained. Can affect serving combinations. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_update_conversion_action
ChatGPTEdit owned conversion configuration using expected_action_hash. Omitted fields and omitted nested value settings are preserved with exact update masks. Classification, primary goal, values, counting, windows and attribution can affect reporting and bidding. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_update_experiment
ChatGPTEdit supplied experiment name/description/dates/goals through exact masks and expected_experiment_hash. Type and sync choice stay immutable; lifecycle transitions use their named actions. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_update_experiment_arms
ChatGPTAtomically edit owned SETUP arm names/traffic while preserving control roles and campaign references. Final arm set needs one control and 100% total traffic. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_update_extension_asset
ChatGPTUpdate supplied shared extension content of the same type. All ads using this asset, including active ads, can change. Omitted sitelink descriptions are preserved. Preview is server-validated. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_update_label
ChatGPTEdit supplied owned label metadata after matching google_label_context. Omitted fields are preserved; an empty description clears it. Changes every use of this shared label, including reports and automation. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_update_performance_max_brand_assets
ChatGPTAtomically change campaign-level BUSINESS_NAME/LOGO/LANDSCAPE_LOGO links for brand-guidelines campaigns with expected_campaign_hash. Affects every group in the campaign, including serving creative combinations. Preserves sources/status/budget and native minimum branding. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_update_responsive_search_ad
ChatGPTEdit an existing responsive search ad’s headlines, descriptions, final URLs or display paths. Omitted fields remain unchanged. Existing headline and description pinning is retained by position. Serving status does not change. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_update_targeting
ChatGPTEdit existing campaign targeting with snapshot_hash and delivery-effects acknowledgement. Location/language additions/removals preserve unmentioned criteria; schedules replace weekly intervals; device multipliers edit existing types. Exact native masks, atomic validateOnly and independent readback. Search languages can only be removed. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_upload_call_conversions
ChatGPTUpload 1–2000 call conversions to an enabled UPLOAD_CALLS action with expected_action_hash. Requires actual E.164 caller ID, call start, later conversion time, value and currency. Native validate_only preview; row failures/uncertainty are reported without automatic retries. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_upload_click_conversions
ChatGPTUpload 1–2000 captured click conversions or enhanced leads through the legacy Google Ads endpoint using expected_action_hash. Supports captured GCLID/GBRAID/WBRAID together, explicit consent and SHA-256 identifiers. Legacy access is restricted for new adopters; Data Manager is a separate API. Native validate_only preview; partial row outcomes are explicit. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_upload_conversion_adjustments
ChatGPTRetract, restate or enhance 1–2000 existing conversions using expected_action_hash and their original order ID or supported GCLID/date-time pair. Restatements use the final total value; enhancements require order ID and separately hashed identifiers. Native validate_only preview; affects reporting/bidding and reports partial outcomes. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
google_upload_image_asset
ChatGPTUpload a SHA-256-bound PNG/JPEG/GIF as an unattached Google asset. Hosted calls require project media_id. Preview uses native validate_only. Assets cannot be deleted; no ad or serving association is created. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_archive_lead_form
ChatGPTArchive a PUBLISHED owned form with expected_snapshot_hash. This can stop its linked creatives serving; no restore transition is exposed. No deletion or scope changes. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_budget_pricing
ChatGPTRead native bid limits, suggested bids and daily budget limits for targeting, bid type and campaign format. Uses actual account currency and exact decimal results; does not validate campaign creation or change money/delivery. Planning objective/optimization codes are native, not campaign-create aliases. LinkedIn tools may not be used to discriminate based on personal characteristics such as gender, age, race, or ethnicity. Learn more: https://www.linkedin.com/legal/ads-policy
linkedin_campaign_conversions
ChatGPTRead selected-campaign conversion associations with verified campaign ownership and native offset paging. complete_snapshot traverses up to 5,000 associations for a verified associations_snapshot_hash; the widget shows at most 100 rows.
linkedin_conversions
ChatGPTList conversion rules and configuration snapshots using the selected advertiser finder and native offset paging. Disabled rules remain visible. Optional shared rules are read-only; no scope or tracking changes.
linkedin_create_campaign
ChatGPTCreate a paused LinkedIn campaign with account-currency budgets in micros. Explicit non-political advertiser consent required. Preview is local. LinkedIn tools may not be used to discriminate based on personal characteristics such as gender, age, race, or ethnicity. Learn more: https://www.linkedin.com/legal/ads-policy Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_create_campaign_group
ChatGPTCreate a native DRAFT campaign group. paused_creation coerces requested ACTIVE to non-serving DRAFT because LinkedIn does not create groups as PAUSED. Optional total cap uses micros. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_create_conversion
ChatGPTCreate an Insight Tag or Conversions API rule using expected_account_hash. Disabled by default, with explicit attribution windows and no automatic campaign association. CAPI needs native rw_conversions access. No tracking events or OAuth changes. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_create_insight_tag
ChatGPTCreate the advertiser’s Insight Tag only if absent, using expected_account_hash from linkedin_insight_tags. Native first-party tracking defaults true; no code installation, scope changes or event sending. Verify native readback. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_create_lead_form_draft
ChatGPTCreate an advertiser-owned DRAFT with localized questions, legal/thank-you content and hidden fields. Bind expected_account_hash from linkedin_lead_forms. No publication, creative linking, lead collection or scope changes. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_create_reference_ad
ChatGPTCreate a paused creative reusing the post of an existing creative in this same account, under a compatible owned campaign/Page. Does not publish another post or change the source ad. For lead campaigns supply lead_form with current form/campaign/source hashes; document lead ads require a fresh document through sponsored-ad creation. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_create_saved_audience
ChatGPTCreate a saved targeting template using expected_account_hash from linkedin_saved_audiences. Native name≤100/description≤500. Does not send a campaign update; no automatic retry. Creation is independently read back. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_create_text_ad
ChatGPTCreate a native text creative under a TEXT_AD campaign, paused by policy. Requires explicit non-political advertiser confirmation; optional image must belong to the account. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_creative_lead_form
ChatGPTView a creative’s owned lead form, CTA and hashes, with verified native copy/media when available. Agents prepare label or DRAFT-destination edits for the normal native approval card.
linkedin_creative_preview
ChatGPTRender an owned creative using native headline, introduction, body, landing page and primary asset metadata (single-creative API202610). Metadata is read-only; missing fields stay unavailable. Account/campaign ownership is checked.
linkedin_creatives
ChatGPTView account-owned creatives and actual text-ad copy/images. With include_media, non-text formats use individual API202610 metadata reads for native copy and primary previews. Full sponsored-post contents require separate Page access; missing details remain explicit.
linkedin_delete_campaign
ChatGPTDelete a draft campaign or request PENDING_DELETION for a non-draft. Rejects campaigns with non-removed creatives; clean children first. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_delete_campaign_group
ChatGPTDelete an empty draft group or request PENDING_DELETION for other states. Rejects groups containing non-removed campaigns; clean children first. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_delete_creative
ChatGPTDelete an eligible draft creative, or request PENDING_DELETION for other states using the native lifecycle. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_delete_saved_audience
ChatGPTPermanently delete one advertiser-owned saved targeting template using expected_snapshot_hash. Native204 confirms deletion; no restore endpoint or automatic retry. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_demographic_report
ChatGPTRead native professional-demographic ad metrics by company size, industry, seniority, title, function, country, region or company. UTC dates are inclusive; exact spend strings and missing values are preserved. Results are approximate/privacy-filtered, not complete audience totals. Optional bounded URN name lookup. No native paging. LinkedIn tools may not be used to discriminate based on personal characteristics such as gender, age, race, or ethnicity. Learn more: https://www.linkedin.com/legal/ads-policy
linkedin_get_account
ChatGPTRead exact native account settings, status and organization reference after verifying the selected account ID. Account discovery does not establish billing readiness or Page permissions.
linkedin_get_campaign
ChatGPTRead exact account-owned campaign settings, native targeting, bid, budgets and schedule.
linkedin_get_campaign_group
ChatGPTRead one account-owned campaign group, including shared/dynamic budget settings and schedule.
linkedin_get_conversion
ChatGPTRead one advertiser-owned conversion, its exact attribution/value/URL rules and snapshot_hash. Returned pixel code is inert text. No conversion event is sent.
linkedin_get_creative
ChatGPTRead one creative, verifying account and parent campaign ownership before returning native content/review settings.
linkedin_get_document
ChatGPTRead a PDF document’s native processing status and expiring download URL, requiring its owner to match the selected sponsored account. Organization/member-owned documents need their own access workflow.
linkedin_get_image
ChatGPTRead a native image associated with the selected account, including processing readiness and an expiring preview URL.
linkedin_get_lead_form
ChatGPTRead one advertiser-owned lead form and its snapshot_hash. IDs must be exact decimal strings; form configuration excludes submitted lead data.
linkedin_get_library_image
ChatGPTRead one exact image through the selected account media-library finder, including archived entries, native readiness and preview. Searches at most 5,000 entries and fails explicitly if membership cannot be confirmed.
linkedin_get_library_video
ChatGPTResolve an exact video through the selected account’s media-library finder, including archived entries. Returns processing status and library_snapshot_hash; membership lookup is bounded to 5,000 entries.
linkedin_get_saved_audience
ChatGPTRead one saved audience template, verify advertiser/ID and return its current snapshot_hash for guarded edits/deletion.
linkedin_images
ChatGPTView the selected account’s native media-library images, processing status and expiring previews. Archive status affects library visibility, not delivery of existing ads.
linkedin_insight_tag_domains
ChatGPTRead domains and callback diagnostics for the advertiser’s verified Insight Tag with native offset paging. No tag execution or domain setting changes.
linkedin_insight_tags
ChatGPTRead the selected advertiser’s single Insight Tag, associated accounts, inert tag code and current snapshot. Returns account_snapshot_hash for creation. Does not install tracking or send events.
linkedin_lead_ad_context
ChatGPTRead an advertiser-owned lead form plus optional supported LEAD_GENERATION campaign/source creative, with creation hashes. No submitted leads. Native Page permissions are separate from form access.
linkedin_lead_forms
ChatGPTList advertiser-owned lead form configuration with exact string IDs, paging and snapshot hashes. No submitted leads or extra scopes.
linkedin_list_campaign_groups
ChatGPTList LinkedIn campaign groups to select a parent for campaign creation.
linkedin_list_campaigns
ChatGPTList LinkedIn campaigns, including inactive campaigns.
linkedin_media_context
ChatGPTRead the account organization reference or an owned campaign’s associatedEntity for video ownership, plus the sponsored-account document owner. Pass video_owner as owner_organization on upload. Does not infer Page permissions or request new grants.
linkedin_rename_creative
ChatGPTRename one verified creative without changing its content or intended delivery status. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_resolve_targeting_entities
ChatGPTResolve up to 100 exact demographic/targeting taxonomy URNs to native localized names. SINGLE_NODE only; no descendant expansion. Unknown names stay unresolved. Verifies selected-account access before the public taxonomy lookup.
linkedin_saved_audiences
ChatGPTList advertiser-owned saved audience templates with native account finder, sort and offset paging. Returns account_snapshot_hash for creation and per-template snapshots. Missing paging metadata means unknown completeness.
linkedin_set_bid
ChatGPTChange an existing campaign unitCost in integer micros, preserving its currency, pricing model and bidding strategy. Current value is required for policy checks. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_set_budget
ChatGPTChange an existing daily or total LinkedIn campaign budget in integer micros, preserving currency and other budget fields. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_set_campaign_conversion
ChatGPTAssociate or detach an owned conversion from a verified advertiser campaign using current conversion and complete-association hashes. Native PUT/DELETE is independently read back. Status/budget unchanged; no events are sent. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_set_campaign_group_budget
ChatGPTChange an existing ordinary group lifetime cap in micros, preserving currency and end time. Dynamic group-budget mode is rejected. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_set_campaign_group_status
ChatGPTPause, activate or archive an owned group. Activation requires explicit advertiser confirmation; affects eligibility of all contained campaigns. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_set_campaign_status
ChatGPTPause or activate a LinkedIn campaign. Activation requires explicit non-political advertiser consent. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_set_creative_lead_form
ChatGPTAttach/replace an owned lead form on a DRAFT creative, or edit the label of its existing form. Exact creative/campaign/form snapshots required. Preserves content and delivery status; label changes can affect serving ads. No publication, events or submitted leads. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_set_creative_status
ChatGPTPause, activate or archive one verified creative. Activation requires explicit advertiser confirmation; parent campaign status remains separate. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_supply_forecast
ChatGPTRead hypothetical supply/spend/response estimates and native uncertainty bounds for a future UTC range. Choose manual bid or auto/target/cap mode; budget/bid inputs are integer account-currency micros. Preserves per-million units and overlapping native periods. Does not create, activate or validate a campaign.
linkedin_targeting_entities
ChatGPTSearch native targeting entities with query (typeahead), or browse a supported facet without query. Locations/profileLocations require query and return modern geo URNs. Missing or contradictory paging is reported as unknown completeness. LinkedIn tools may not be used to discriminate based on personal characteristics such as gender, age, race, or ethnicity. Learn more: https://www.linkedin.com/legal/ads-policy
linkedin_targeting_facets
ChatGPTRead available native targeting facets and supported entity finders. LinkedIn tools may not be used to discriminate based on personal characteristics such as gender, age, race, or ethnicity. Learn more: https://www.linkedin.com/legal/ads-policy
linkedin_update_campaign
ChatGPTEdit supplied campaign name/start/end fields, preserving omitted settings and status. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_update_campaign_group
ChatGPTEdit supplied group name/start/end fields, preserving the existing schedule. Does not change status or budgeting mode. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_update_conversion
ChatGPTEdit supplied conversion name, enabled state, type, attribution windows, exact-currency value or complete URL expression using expected_snapshot_hash. Omitted settings stay unchanged. enabled=false disables the rule; no invented rule DELETE endpoint. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_update_image
ChatGPTRename or archive/unarchive an image in the selected account’s native media library. Preserves the image and existing ads; this is not image deletion or an ad-status change. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_update_insight_tag
ChatGPTChange first-party tracking on one unshared advertiser Insight Tag using its current snapshot. Shared global settings require separate multi-account authorization. No code installation or events; verify native readback. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_update_lead_form
ChatGPTEdit an owned form with expected_snapshot_hash. Full schema edits require DRAFT; published copy/legal/thank-you edits remain subject to native eligibility. Supplied arrays and localized maps replace; omitted settings stay. CRM remapping may be required. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_update_saved_audience
ChatGPTUpdate supplied saved-template name, description or complete targeting_criteria using expected_snapshot_hash. Omitted fields stay unchanged; empty description clears text. Verifies native readback; no campaign update or automatic retry. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_update_targeting
ChatGPTReplace supplied include clauses while preserving an omitted exclusion clause. Expansion changes must be explicit. LinkedIn tools may not be used to discriminate based on personal characteristics such as gender, age, race, or ethnicity. Learn more: https://www.linkedin.com/legal/ads-policy Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_update_text_ad
ChatGPTEdit supplied text-ad headline/body/destination/image fields, preserving omitted content and delivery status. Can trigger creative review. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_update_video
ChatGPTRename or archive/unarchive an account-library video with expected_library_hash. Native processing transitions are checked; bytes, posts and ad delivery remain unchanged. Readback verifies the metadata update. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_upload_document
ChatGPTUpload a checksum-bound PDF owned by the selected sponsored account. No post or ad is published; native processing and the 300-page limit are checked separately. Hosted uploads use media_id. Office formats are not accepted by this tool. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_upload_image
ChatGPTInitialize and upload SHA-256-bound PNG/JPEG/GIF bytes to an account-owned native image/media-library entry. Check readiness with linkedin_get_library_image after upload acceptance. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_upload_video
ChatGPTUpload checksum-bound MP4 parts and finalize in the account’s video library. owner_organization must match media context; optional campaign_id selects its owned associatedEntity. Native Page ADMIN/DSC permission required. No post/ad is created. Processing readiness is a separate read; hosted uploads use media_id. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
linkedin_videos
ChatGPTView account-library video readiness, actual native previews and bound name/archive actions. ACTIVE/ARCHIVED describe library visibility, not ad delivery. Continue next_start as start.
media_delete
ChatGPTPermanently remove a project library source after matching its current name and SHA-256. Blocks further reuse and removes stored bytes; expired-grant cleanup retains a temporary deletion record. Does not delete provider copies, ads or campaigns. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
media_distribution_plan
ChatGPTPlan reuse of one central project asset across connected, enabled ad accounts. Returns existing guarded provider upload tools and exact source arguments; missing provider-specific choices are explicit. No upload, approval token, ad creation or publication. Spotify/Snapchat first prepare an asset container, then plan again with its ID. Pinterest images create original Pins and require explicit board visibility and content consent.
media_distributions
ChatGPTRead the selected project source’s last50 native upload attempts, destinations and resource IDs. ACCEPTED means the upload request completed, not processing readiness or ad publication. STARTED/UNCONFIRMED require reconciliation; never replay them blindly.
media_finalize_upload
ChatGPTVerify a prepared raw-byte or MCP-part upload and mark it ready for provider tools. Requires the reserved whole-file checksum. Preview checks stored bytes without finalizing; apply assembles parts if needed and returns immutable media_id, SHA-256 and metadata. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
media_get
ChatGPTRead a project file, preview when READY, and unfinished upload expiry, MCP parts and whole-file Storage presence. PRESENT_UNVERIFIED is metadata only; declared SHA-256 and empty received_parts do not prove transferred bytes. Finalization stays preview/apply. Download ready asset.preview_url with HTTP GET.
media_import_file
ChatGPTImport a ChatGPT host-provided attachment into private project media, up to 50 MiB, without base64, external upload commands or a dashboard. First media_inspect_file supplies exact name/MIME/size/SHA-256. Preview and apply download and verify the same approved bytes; changed or expired files reject. No advertising upload or publication. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
media_inspect_file
ChatGPTInspect a host-provided ChatGPT attachment without storing it: download exact bytes from the allowed OpenAI file origin, detect MIME, verify size, decode images and compute SHA-256. No base64 or dashboard. Use returned metadata with media_import_file to preview a private project import. Other hosts need a supported file transport.
media_list
ChatGPTSearch central project media by name, kind, tag, platform or status (default READY). PROCESSING/FAILED recover interrupted upload IDs; media_get reads their progress. Labels do not publish. Upload via media_inspect_file → media_import_file (ChatGPT), media_upload (up to1MiB), or prepare → PUT/parts → finalize (up to50MiB). Use media_distribution_plan to reuse exact source bytes on channels.
media_prepare_upload
ChatGPTReserve an immutable project file up to 50 MiB. Apply returns a temporary raw HTTP PUT grant and an MCP-only media_upload_part plan. Transfer the bytes by either method, then preview/apply media_finalize_upload. No dashboard, ad account mutation or publication. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
media_rename
ChatGPTRename project media metadata after matching its current name and immutable SHA-256. File bytes, ID and existing provider copies are preserved. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
media_update_metadata
ChatGPTEdit a project asset name or replace its tags and platform labels. Empty lists clear the corresponding labels. Requires the version and SHA-256 from media_get. Changes are limited to Adport project metadata. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
media_upload
ChatGPTUpload a small project file directly as canonical base64 (at most 1 MiB decoded). SHA-256, declared length and actual MIME must match. Preview verifies bytes; apply stores and verifies them, returning media_id. For larger files use media_prepare_upload with raw HTTP PUT or media_upload_part. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
media_upload_part
ChatGPTTransfer one immutable 1 MiB base64 part through MCP after media_prepare_upload. Zero-based indexes; only the last part may be shorter. Bind the reserved whole-file checksum and exact part checksum. Preview/apply each part; inspect media_get after unknown outcomes. Finalize separately. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_advertisable_applications
ChatGPTFind the Meta application IDs and store URLs available to the selected ad account for app-promotion campaigns. Continue next_cursor as after. Does not return app credentials.
meta_create_ad
ChatGPTCreate an ad referencing an account-owned ad set and creative. Policy may force PAUSED; parent campaigns and ad sets are unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_create_ad_set
ChatGPTCreate an ad set in a campaign with minimal country targeting. Omit daily_budget_cents when the campaign uses CBO. Defaults: LINK_CLICKS optimization, IMPRESSIONS billing. With an ad-set budget and no bidding inputs, uses LOWEST_COST_WITHOUT_CAP; otherwise omitted strategy inherits campaign bidding. Bid/cost caps require bid_amount; minimum ROAS requires bid_constraints and VALUE optimization. For EU targeting supply dsa_beneficiary and dsa_payor with the actual advertiser and payer names. Meta validates compatibility before apply. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
meta_create_campaign
ChatGPTCreate a Meta campaign. Budget is optional at campaign level (Advantage/CBO) — otherwise set it on ad sets. special_ad_categories is required by Meta for regulated verticals; defaults to none. Creates only a campaign, not ad sets, ads or creatives. The first call previews; an identical call with the pending token applies. Workspace policy can force paused creation. No ad is published by this tool. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
meta_create_creative
ChatGPTCreate an immutable creative from an existing Page post OR provider-shaped object_story_spec (image, video or carousel). Content changes require a new creative, then meta_update_ad to attach it. Does not create or publish an ad. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_create_custom_audience
ChatGPTCreate an empty customer-list audience container. Does not upload customer data or attach the audience to delivery. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_create_custom_conversion
ChatGPTCreate a website custom conversion from a Pixel verified in this account. Native rule JSON grammar is validated by Meta at apply. Preview is local; creates only a definition and sends no events. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_create_link_creative
ChatGPTCreate a new image/link creative using an uploaded account image hash and an accessible Facebook Page. Does not replace an existing ad or publish a post. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_create_lookalike_audience
ChatGPTCreate an unattached custom-ratio lookalike from an owned source with expected_source_hash. country uses two uppercase letters; ratio/starting_ratio are fractions. Native eligibility and seed readiness remain authoritative. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_create_pixel
ChatGPTCreate a Meta pixel in the selected ad account. Does not install tracking code or send events. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_create_website_audience
ChatGPTCreate a URL-contains website audience from a pixel verified in this account. retention_seconds and explicit historical prefill are required. No events sent or delivery attachment; native eligibility applies. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_custom_audience_usage
ChatGPTInspect selected-account ad-set, saved-audience and audience references, derived lookalikes and native sharing before deletion. Returns context_hash and bounded scan completeness; no global or atomic usage guarantee.
meta_custom_conversion_stats
ChatGPTRead native custom-conversion stats for an owned conversion and explicit ISO time range. Preserves Meta aggregation/data/timestamp values; does not fabricate missing counts or convert currency. Continue next_cursor as cursor.
meta_custom_conversion_usage
ChatGPTScan visible selected-account ad-set references before deletion. Returns context_hash and bounded scan completeness; does not establish global sharing or usage.
meta_delete_creative
ChatGPTPermanently delete an account-owned creative. This cannot be undone; review existing ad references before applying. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_delete_custom_audience
ChatGPTPermanently delete an owned editable audience with expected_context_hash from meta_custom_audience_usage. Refuses visible references, sharing, derived audiences and incomplete scans; rechecks at apply. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_delete_custom_conversion
ChatGPTDelete an owned conversion with expected_context_hash from usage and shared-effects acknowledgement. Refuses visible ad-set references/incomplete scans. Rechecks at apply, then verifies native archived state or complete account-list absence; no restore operation. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_delete_image
ChatGPTPermanently remove an image hash from the selected account image library. This cannot be undone; review existing creative references before applying. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_delivery_estimate
ChatGPTRead Meta delivery estimates for a provider-shaped targeting specification and optimization goal. Estimates are not delivery guarantees.
meta_get_campaign
ChatGPTRead one Meta campaign by ID, verifying that it belongs to the selected connected ad account. Returns name, delivery status, objective and budgets in minor currency units. Does not change the campaign.
meta_get_custom_audience
ChatGPTRead owned audience configuration and snapshot_hash for edits/lookalike creation. Volatile size/readiness values are excluded from the hash.
meta_get_custom_conversion
ChatGPTRead an owned Meta custom-conversion definition and snapshot_hash for metadata edits. Native first/last event timestamps and Pixel name are excluded from the hash.
meta_insights
ChatGPTQuery the Meta Ads Insights API directly: pick a level (account/campaign/adset/ad), fields (spend, impressions, clicks, actions, action_values, purchase_roas, campaign_name, ...), and a date_preset (last_7d, last_30d, maximum, ...) or explicit time_range. Values come back as strings; spend is whole currency units.
meta_list_ad_sets
ChatGPTRead full ad-set targeting, delivery, bidding, schedules and budgets in minor currency units.
meta_list_ads
ChatGPTRead ad configuration and creative copy/media with visual editing actions. Filters are optional; IDs remain bound to the selected account.
meta_list_campaigns
ChatGPTList campaigns in one connected Meta ad account with their names, delivery status, objectives and budgets. Budget strings are minor currency units. Does not change campaigns.
meta_list_creatives
ChatGPTRead the selected account creative library, including immutable content, media references and raw creative configuration.
meta_list_custom_audiences
ChatGPTList owned audience configuration and native readiness/count bounds. Continue next_cursor as cursor; no customer records are returned.
meta_list_custom_conversions
ChatGPTList account-owned Meta custom conversions with native cursor pagination. Foreign-owned shared conversions are rejected. Returns configuration without sending events.
meta_list_images
ChatGPTRead account-owned Meta images and their provider configuration.
meta_list_pages
ChatGPTList the Facebook Pages the connected user can access, including their Page roles/tasks. Uses pages_show_list and never returns Page access tokens.
meta_list_pixels
ChatGPTRead account-owned Meta pixels and their provider configuration.
meta_list_videos
ChatGPTRead account-owned Meta videos and their provider configuration.
meta_page_engagement
ChatGPTRead engagement metadata and recent posts for an accessible Facebook Page. Uses pages_read_engagement after verifying the Page belongs to the connected user.
meta_rename_creative
ChatGPTRename an account-owned creative. Meta creative content is immutable; use meta_create_creative to author a replacement. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_search_targeting
ChatGPTDiscover interest, location or locale targeting identifiers from Meta targeting search.
meta_set_ad_set_bidding
ChatGPTEdit an account-owned ad set bidding strategy and optional cap/ROAS floor. Bid amounts use minor currency units. Budgets and targeting remain unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_set_ad_set_status
ChatGPTActivate or pause a Meta ad set. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
meta_set_ad_status
ChatGPTActivate or pause one account-owned ad. Parent delivery settings are unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_set_budget
ChatGPTChange the daily budget of a Meta campaign (CBO) or ad set — pass the object id that owns the budget. The preview shows the current value and fails clearly when the object has no daily budget. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
meta_set_campaign_status
ChatGPTActivate or pause a Meta campaign. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
meta_set_lifetime_budget
ChatGPTChange a campaign or ad set lifetime budget with a current-value lookup and policy delta check. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
meta_update_ad
ChatGPTRename an ad or replace its creative with an existing account-owned creative. Serving status is preserved; replacing an active ad may trigger review and change its displayed content. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_update_custom_audience
ChatGPTEdit audience name/description with expected_snapshot_hash. Omission preserves metadata; an empty description clears it. Membership, targeting and delivery settings are preserved. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_update_custom_conversion
ChatGPTEdit supplied name, description or native default value with expected_snapshot_hash. Omission preserves metadata; empty description clears it. Rule/source/category are immutable here. Requires acknowledging effects wherever this conversion is used. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_update_targeting
ChatGPTReplace one ad set targeting specification after reading its current value. Supply the complete desired targeting object; omitted targeting keys are removed. Budgets and serving status are preserved. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_update_website_audience
ChatGPTReplace the full WEBSITE membership rule with a case-insensitive URL-contains rule and retention_seconds. Requires expected_snapshot_hash and expected_context_hash from usage, plus an account-available pixel. Existing audience use may be affected; omitted metadata and ad statuses/budgets are preserved. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_upload_image
ChatGPTUpload checksum-bound PNG/JPEG image bytes into the selected ad account image library. Hosted calls require media_id; file_path is local-only. Does not publish an ad. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
meta_upload_video
ChatGPTUpload checksum-bound MP4/MOV video bytes into the selected account library. Hosted calls require media_id; file_path is local-only. Video processing continues asynchronously; read meta_list_videos before use. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_ad_extension_associations
ChatGPTRead direct extension associations for an account, campaign or verified ad group. Native editorial status is preserved; inherited associations are not combined.
microsoft_ad_extensions
ChatGPTView account-owned callout, sitelink, structured-snippet and image extensions, including native versions and shared-content edit actions. Continue with next_cursor as after_extension_id.
microsoft_ad_groups
ChatGPTRead ad groups and their bids/statuses after verifying the campaign belongs to the selected account.
microsoft_add_audience_target
ChatGPTAssociate or exclude an account-available audience with expected_audience_snapshot_hash. Positive criteria require expected_target_and_bid from target reads and a complete opposite-level check, bounded to 50 ad groups. Preserves parent mode/status; native Active criteria require an effectively paused parent under paused_creation. Performance Max supports campaign exclusions only. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_add_campaign_targets
ChatGPTAdd age, gender, device, day/time, location, location-intent or radius targets; locations can be excluded. Native targets are Active; default paused_creation requires a paused campaign. Device creation requires all three device types together. Bids are integer percent adjustments. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_add_keywords
ChatGPTCreate up to 100 keywords in an account-owned ad group. Bids use whole currency units. Policy may force Paused. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_add_negative_keywords
ChatGPTAppend up to 1000 direct Exact/Phrase exclusions to an owned campaign or ad group. Native negative keywords have no pause state and only restrict delivery; parent status is preserved. Verifies every created ID and its text/match type. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_ads
ChatGPTRead ad configuration and creative copy with visual edit actions. Verifies the campaign/ad-group hierarchy in the selected account.
microsoft_assign_shared_budget
ChatGPTAssign a campaign to an owned daily pool using campaign and destination snapshot hashes. Compares current effective limit with the pool amount for policy; preserves status. Excludes Performance Max, Smart Shopping and experiments. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_audience_targets
ChatGPTRead campaign or ad-group audience associations/exclusions of one concrete audience type. Returns native criteria, snapshots and verified parent target-mode/status context. Campaign TargetSetting is explicitly requested. Continue next_cursor as after_criterion_id.
microsoft_audience_usage
ChatGPTCheck an owned unshared Account remarketing list and its derived similar lists for campaign/ad-group criteria, combined-list and audience-signal references. Bounded to 200 campaigns, 2000 ad groups and fewer than 100 signals; incomplete/unsupported scans fail closed.
microsoft_audiences
ChatGPTRead account-associated native audiences with configuration hashes. Preserves unavailable sizes. Sharing graphs are omitted; shared is reported. System-generated visitor/converter/Smart lists are not supported by this API. CustomSegment is opt-in; reserved AIPrompt is excluded. Continue next_cursor as after_audience_id.
microsoft_campaign_budget
ChatGPTRead an owned campaign’s effective daily limit, individual/shared budget, members and snapshot_hash. Use this hash as expected_campaign_hash when assigning or detaching.
microsoft_campaign_targets
ChatGPTRead one concrete campaign targeting subtype with verified campaign/account ownership. Native criterion and percent bid adjustments are preserved. Targets is a mutation selector and cannot be used for reads.
microsoft_campaigns
ChatGPTList all eight Microsoft Advertising campaign types (Id, Name, Status, DailyBudget in account currency, BudgetId when shared).
microsoft_conversion_goals
ChatGPTRead account-associated native goals, tracking state, configuration hashes and account-level click-ID auto-tagging. Default excludes pilot-only InStoreTransaction, whose inclusion can reject the entire query. Continue next_cursor as after_goal_id.
microsoft_create_ad_extension
ChatGPTCreate an unattached callout, sitelink, structured-snippet or image extension. Native status is Active but no serving association is created. Uses full native content readback. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_create_ad_group
ChatGPTCreate a SearchStandard ad group in an account-owned campaign. CPC bid uses whole account-currency units; policy may force Paused. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_create_campaign
ChatGPTCreate a Microsoft Advertising Search campaign. daily_budget is a float in account currency. The API's own default status is Paused. No server dry-run — previews are client-side diffs. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_create_conversion_goal
ChatGPTCreate an account-scoped URL, Event or OfflineConversion goal. Defaults Paused and excluded from bidding. Native add automatically enables click-ID auto-tagging; supply its expected state from conversion-goal reads. Does not install tracking or send events. Goals cannot be permanently deleted through this API. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_create_experiment
ChatGPTCreate a native campaign-copy experiment with expected_base_context_hash. Paused creation requires a currently Paused base; native Active setup input becomes Creating. Dates use base timezone. Splits existing daily budget/traffic rather than adding a pool. Shared-budget, DSA, mixed/specialized or experiment bases are rejected. Setup is asynchronous. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_create_responsive_search_ad
ChatGPTCreate a responsive search ad using 3–15 unique headlines and 2–4 unique descriptions in a SearchStandard ad group. Policy may force Paused. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_create_shared_budget
ChatGPTCreate an unattached DailyBudgetStandard pool in account currency. Checks its amount in policy micros. Does not assign or activate campaigns. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_create_uet_tag
ChatGPTCreate one uninstalled UET tag in the selected account’s native customer library. Requires expected_customer_id from linked-tag reads; rechecks current parent ownership. Returns its ID for paused goal setup. No installation or event sending; tags have no pause state. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_delete_ad_extension
ChatGPTPermanently delete an account-owned shared extension and its associations. Requires its latest native version. Source images remain in the account library. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_delete_experiment
ChatGPTDelete an exact owned experiment and its coupled campaign copy with expected_snapshot_hash; preserve the base. Confirms disappearance before success. Do not retry accepted-but-unconfirmed receipts without reconciling their IDs. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_delete_image
ChatGPTPermanently delete an account-owned image only if Microsoft verifies it is unassigned. Preflight checks image-extension uses; native deletion also rejects responsive-ad assignments. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_delete_shared_budget
ChatGPTPermanently delete an owned unused shared budget. Requires matching snapshot and both native and discovered campaign counts zero; verifies disappearance. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_end_experiment
ChatGPTEnd an owned settled experiment early with expected_snapshot_hash. This cannot be restarted and pauses its campaign copy; the base campaign is preserved. Pausing temporarily is instead coupled to pausing the base campaign. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_experiment_base_context
ChatGPTRead an owned base campaign, its native active experiments, currency and snapshot_hash for creation. Budgets/status/timezone are inherited by experiment copies. Snapshot covers campaign configuration and visible active inventory, not every child entity.
microsoft_experiments
ChatGPTRead native active experiments only; this inventory does not establish absence of historical experiments. Use get for an exact known ID. Continue next_cursor as after_experiment_id.
microsoft_geo_locations_file
ChatGPTGet the native geographical-location file URL, server expiration and modification time. Use current non-deprecated location IDs for targeting; returns metadata without downloading or caching the file.
microsoft_get_ad_extension
ChatGPTRead one extension by exact ID and type in the selected account, including the native version required for edits.
microsoft_get_audience
ChatGPTRead one account-associated native audience and snapshot_hash. Customer-scoped or shared lists are readable but cannot be changed by single-account remarketing tools. System-owned sizes are excluded from the hash.
microsoft_get_conversion_goal
ChatGPTRead one account-associated native goal and snapshot_hash. TrackingStatus is system-owned and excluded from the configuration hash. Customer-scoped goals cannot be edited through single-account tools.
microsoft_get_experiment
ChatGPTRead an exact known experiment, verified base/experiment campaign ownership, native setup state and coupled snapshot_hash. Creating is asynchronous acceptance, not readiness.
microsoft_get_library_image
ChatGPTRead one image through the selected account library finder, including native alt text and previews. Ownership lookup is bounded to 5000 images.
microsoft_get_shared_budget
ChatGPTRead an owned daily pool, its campaign members and snapshot_hash for update, assignment or deletion. Writes reject incomplete membership.
microsoft_image_extension_associations
ChatGPTRead image-extension references for an account-owned image. This API does not return responsive-ad references; an empty result does not prove global non-use.
microsoft_images
ChatGPTView account-library image metadata, alt text and native image previews. Native page indexes start at zero; a full page may have a continuation.
microsoft_keyword_historical_metrics
ChatGPTRead native keyword attributes without expanding seeds: demand history, competition and estimated bids. Monthly counts newest-first; missing values remain unavailable. Exact month labels require explicit date_range.
microsoft_keyword_ideas
ChatGPTRead Ad Insight keyword ideas from keyword, HTTPS URL or native category seeds. Requires language and location IDs; suggested bids use account currency. Native cap 3000, no pagination; monthly counts newest-first and undated unless date_range supplied.
microsoft_keyword_report
ChatGPTRead the native Microsoft keyword performance report through Submit/Poll/CSV. Native numeric values remain strings; empty or unavailable values are preserved.
microsoft_keyword_traffic_estimates
ChatGPTEstimate hypothetical weekly Phrase/Broad keyword traffic from bids, language, locations and network, optionally daily budget and exclusions. Read-only; no campaign changes. Cost/bids use account currency. AveragePosition is deprecated and always zero.
microsoft_keywords
ChatGPTRead ad-group keywords, including bids, match types, statuses and URLs, within the selected campaign/account.
microsoft_link_ad_extension
ChatGPTAssociate a version-verified extension with one owned entity. Associations cannot be paused; default paused_creation requires a paused parent campaign or ad group. Account-wide associations are blocked under that policy. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_linked_uet_tags
ChatGPTRead current native_customer_id plus UET metadata/code only for tags referenced by selected-account goals. Tags are customer-scoped; the entire library and sharing graph are not exposed. Continue next_cursor as after_tag_id.
microsoft_negative_keywords
ChatGPTRead direct campaign or ad-group negative keywords after verifying the full account/parent hierarchy. Shared-list and inherited exclusions are separate. Continue with next_cursor as after_keyword_id.
microsoft_offline_conversion_goal_report
ChatGPTRead offline conversion attribution diagnostics for up to 20 unique account-available OfflineConversion goals and at most seven days in UTC. Native channel flags are optional CSV filters. Returns aggregate/daily ratios and counts, explicit per-goal errors and missing summaries; never infers zero for missing data.
microsoft_offline_conversion_reports
ChatGPTRead daily offline-conversion upload success/failure counts in an explicit UTC interval (tool bound: seven days). Preserves native dates/counts; omits signed file URLs and pilot event/customer records. Downloads and event ingestion are separate workflows.
microsoft_remove_audience_target
ChatGPTRemove an exact owned audience association/exclusion with expected_snapshot_hash. This can broaden or narrow delivery; preserves target mode and other criteria. Confirms disappearance before reporting success. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_remove_campaign_targets
ChatGPTRemove exact owned criterion IDs of one subtype. Devices require all three IDs together. Location intent cannot be deleted; use its edit tool instead. Other targets remain; removing restrictions can broaden delivery. Confirms native disappearance. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_remove_keywords
ChatGPTPermanently remove verified keyword IDs from an ad group. This cannot be undone; use microsoft_set_keyword_status to pause instead. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_remove_negative_keywords
ChatGPTRemove exact owned direct exclusion IDs. This can broaden delivery. Text and match type are immutable: add and confirm a replacement before removing its predecessor. Shared and inherited exclusions are separate. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_search_term_report
ChatGPTRead the native Microsoft search term performance report through Submit/Poll/CSV. Native numeric values remain strings; empty or unavailable values are preserved.
microsoft_set_ad_group_status
ChatGPTActivate or pause an account-owned ad group; the parent campaign status remains unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_set_ad_status
ChatGPTActivate or pause an ad after verifying its exact parent hierarchy. Parent delivery settings remain unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_set_audience_target_bid
ChatGPTEdit an owned positive audience criterion percentage adjustment (-90..900, integer) with expected_snapshot_hash. Preserves audience identity, delivery mode and parent status. Exclusions do not accept bids. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_set_audience_target_mode
ChatGPTSet TargetAndBid (restrict positive audience delivery) or BidOnly (bid adjustment without that restriction) with expected_context_hash from target reads. Preserves all other target-setting details and other settings; affects all positive audiences on that entity. Performance Max uses signals and exclusions instead. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_set_budget
ChatGPTChange a Microsoft base campaign's DailyBudget (float, account currency). Related campaign-copy experiments split this total pool. Direct experiment-campaign edits and shared budgets are refused. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_set_campaign_location_intent
ChatGPTChange campaign location intent with an expected current value. PeopleInOrSearchingForOrViewingPages restores the API default; this criterion cannot be deleted. Preserves status and omits the inapplicable bid multiplier. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_set_campaign_status
ChatGPTActivate or pause a Microsoft Advertising base campaign; related active/scheduled experiments inherit its serving status. Direct experiment-campaign status edits are refused. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_set_campaign_target_bid
ChatGPTChange a biddable target percentage adjustment with an expected current value. Device range -100..900; other supported targets -90..900. Excluded locations and location-intent criteria do not accept bids. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_set_keyword_bid
ChatGPTChange one verified keyword bid in whole currency units; keyword and parent statuses remain unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_set_keyword_status
ChatGPTActivate or pause one verified keyword without replacing its text, match type or bid. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_shared_budgets
ChatGPTList native daily pools with all-type campaign membership, completeness and snapshot hashes. Continue next_cursor as after_budget_id.
microsoft_targeting_context
ChatGPTRead owned and inherited campaign/ad-group general targets, effective sources, schedule clock and context_hash. Seven concrete types, complete bounded context and stable paging; bid values are percentages. This is not audience targeting or every native targeting family.
microsoft_unassign_shared_budget
ChatGPTDetach to an explicit individual DailyBudgetStandard budget in account currency. Requires campaign snapshot, preserves status and remaining pool amount, and checks monetary policy. Excludes experiment campaigns. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_unlink_ad_extension
ChatGPTRemove one explicit extension association, preserving its source extension and other associations. Does not alter inherited associations or serving statuses. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_update_ad_extension
ChatGPTEdit supplied shared extension content with expected_version. Preserves omitted mutable fields and scheduling; all associated entities can change. Image alt text here belongs to the extension, not the source media. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_update_ad_group
ChatGPTRename an ad group or change its CPC bid in whole currency units. Campaign and ad-group status remain unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_update_conversion_goal
ChatGPTEdit an Account-scoped URL/Event/Offline goal with expected_snapshot_hash. Preserves omitted event criteria, status and other optional settings. Native update enables click-ID auto-tagging. Event conditions, when supplied, replace the full condition set. Use Paused to stop tracking; Deleted is internal-only. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_update_experiment
ChatGPTEdit experiment name or calendar schedule with expected_snapshot_hash. Name changes rename the campaign copy. Native Scheduled status is required before changing start/split; Paused alone is insufficient. end_date:null clears expiry with the native zero Date. No promotion or graduation. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_update_responsive_search_ad
ChatGPTEdit supplied responsive search ad fields. Omitted fields and serving status are preserved; existing positional pinning is retained. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_update_shared_budget
ChatGPTRename or change one shared daily pool after binding its amount and all campaign members/statuses with expected_snapshot_hash. Monetary caps apply once to the pool; no atomic native compare-and-set. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_update_targeting
ChatGPTEdit scoped targeting with expected_context_hash and delivery-effects acknowledgement. One native add, remove, bid, location-intent or schedule-clock operation per approval. Preserves unmentioned criteria/status/budgets; checks inheritance, full devices and schedule limits. New criteria require an effectively paused parent under paused_creation. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_upload_image
ChatGPTUpload a SHA-256-bound static image as an unattached account asset. Hosted calls require project media_id. Native cap 76800 bytes; PNG converts to JPEG. Alt text is set at creation; no serving association is created. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_upload_offline_conversion_adjustments
ChatGPTRestate or retract 1–1,000 previously imported offline conversions with expected_goal_hash. Original conversion_time identifies each record; adjustment_time records the adjustment. Local preview sends nothing. Returns indexed failures and processing acceptance; no automatic retry or per-event readback. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
microsoft_upload_offline_conversions
ChatGPTImport 1–1,000 offline conversions into an existing goal with expected_goal_hash. Local preview sends no events; apply returns sparse indexed failures and acceptance for processing, not attribution. Uses the current exact goal name, preserves its configuration and never retries. Already hashed identifiers require enhanced conversions to be enabled. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_ad_groups
ChatGPTRead advertiser ad-group targeting, budgets, bids and schedules with native bookmark pagination.
pinterest_ads
ChatGPTView advertiser ad settings and referenced Pin copy/media, with bound name/destination/status edit actions. Pin previews require existing boards/pins read permissions; original Pins remain unchanged.
pinterest_apply_catalog_items_batch
ChatGPTSubmit one explicit mixed CREATE/UPDATE/UPSERT/DELETE batch with fresh context_hash and effect confirmations. Native IDs/catalog/market stay fixed; private media is minted only at apply. Async partial results retain per-item states and signed receipt; no automatic retry. Batch arguments stay private; the agent applies identical arguments. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_apply_local_inventory_batch
ChatGPTSubmit mixed local-inventory operations for verified item_id/store_code pairs. Fresh context, publication/effect acknowledgements and permanent-delete confirmation required. Signed async receipt retains per-pair outcomes; agent applies private arguments, with no automatic retry. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_archive_entity
ChatGPTArchive a verified advertiser campaign, ad group or ad through native batch PATCH. This does not delete an original Pin. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_archive_keywords
ChatGPTArchive exact snapshot-bound keywords in one owned parent. Native archive acts like deletion and removes metrics/list visibility; no guaranteed unarchive path. Removing exclusions can broaden matching. No parent status or bid changes. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_audience_estimate
ChatGPTGet a native non-binding audience-size estimate via read-only POST. No targeting or delivery changes.
pinterest_audience_sources
ChatGPTRead the advertiser owner’s native website inventory for engagement audience setup. Global websites require user_accounts:read and matching token owner. Does not claim/verify websites or certify audience eligibility.
pinterest_audience_usage
ChatGPTRead owned audience targeting/derived references and both ad-account/business sharing edges. Bounded5,000 rows per inventory; incomplete or shared usage blocks removal. No native atomic freeze is claimed.
pinterest_audiences
ChatGPTList native OWNED or RECEIVED audiences with ownership labels and snapshots. Received audiences remain read-only. Uses native bookmark pagination; processing status is not ad delivery.
pinterest_boards
ChatGPTList selected advertiser-owner boards, privacy and ownership with native pagination. Public boards require boards:read; secret boards also require boards:read_secret. Collaborator boards are labeled, not treated as owned.
pinterest_campaign_budget_context
ChatGPTRead scoped campaign budget mode/amount, native currency and fresh context_hash. Distinguishes fixed daily, average daily, lifetime, ad-group ownership and unconfirmed modes; no raw tracking URLs or writes.
pinterest_catalog_item_batch_status
ChatGPTRead a batch created by Adport using its signed receipt, current owner/catalog proof and advertiser/project binding. Keeps per-item failures/pending/missing results distinct; overall COMPLETED is not every-item success. Sends no events or mutations.
pinterest_catalog_item_context
ChatGPTValidate exact operations, native field/update-mask shapes, current owned catalog/market/items and checksum-bound media. Returns context_hash; verifies again before apply. No provider links, products, Pins or permissions are created by this read.
pinterest_catalog_item_schema
ChatGPTOn-demand native attribute schema for retail/hotel/Creative Assets CREATE/UPDATE/UPSERT/DELETE. Shows immutable media differences and retail unset-mask fields; native merchant-required fields/eligibility remain authoritative.
pinterest_catalog_items
ChatGPTRead explicit item IDs in one owned catalog/country/language via native POST query. Pages requested IDs with native Pin previews and guarded copy editing. This is not whole-catalog enumeration; missing/error rows never prove absence. Source URLs are fingerprinted.
pinterest_catalogs
ChatGPTList selected advertiser-owner catalogs and context_hash with native bookmarks. Requires catalogs:read; no token-owner fallback.
pinterest_conversion_tag_eligible_events
ChatGPTRead the advertiser’s native OCPM-eligible conversion-tag events without changing optimization.
pinterest_conversion_tag_page_visits
ChatGPTRead native conversion-tag page-visit metadata with bookmark pagination.
pinterest_conversion_tags
ChatGPTRead advertiser-owned conversion tags and code snippets as data. Unpaged native collection; does not install tracking or send events.
pinterest_create_ad
ChatGPTCreate a paused advertiser ad using an existing eligible Pin. This does not edit or publish an organic Pin. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_create_ad_group
ChatGPTCreate a verified campaign’s ad group, paused by policy. Budgets/bids are integer account-currency micros; non-CBO campaigns require an ad-group budget. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_create_audience
ChatGPTCreate CUSTOMER_LIST, VISITOR, ENGAGEMENT or ACTALIKE audience from verified owned sources. Customer/seed snapshots are required; visitor prefill is explicit. No ad attachment, events or tracking installation. Native source eligibility remains authoritative. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_create_board
ChatGPTCreate an advertiser-owned board, SECRET by default. PUBLIC requires confirm_publication; PROTECTED creates an ad-only board with Pinterest-assigned name. Public boards require boards read/write; SECRET also requires boards:read_secret and boards:write_secret. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_create_campaign
ChatGPTCreate a Pinterest CBO campaign, paused by policy. Budgets are account-currency micros; lifetime budgets require an end time. Preview is local. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
pinterest_create_catalog
ChatGPTCreate an empty RETAIL, HOTEL or CREATIVE_ASSETS catalog with context_hash from pinterest_catalogs. No feed/products/ads; catalog programs and catalogs:write required. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_create_catalog_items
ChatGPTCREATE one market's catalog items using fresh context_hash, explicit catalog and native async batches. Read schema before attributes. UPDATE preserves omitted fields; UPSERT is full replacement; DELETE affects all sources. Returns scoped receipt, not item/publication success. Batch arguments stay private; the agent applies identical arguments. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_create_conversion_tag
ChatGPTCreate conversion-tag metadata using expected_context_hash. Enhanced match defaults off and requires consent when enabled. Does not install code or send events; no native tag delete endpoint. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_create_customer_list
ChatGPTUpload up to10,000 unique pre-normalized SHA-256 EMAIL/IDFA/MAID identifiers into a named list. Requires data rights confirmation; is_nca defaults false. Preview shows only count/digest. Acceptance is not matching success; native lists have no container-delete endpoint. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_create_feed
ChatGPTCreate a feed with a public HTTPS source in the selected Pinterest catalog. Defaults to INACTIVE. Confirm access to the source. ACTIVE also requires confirmation that processing can publish product Pins. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_create_image_pin
ChatGPTUpload exact SHA-bound PNG/JPEG bytes and create original Pin content on an owned board. Hosted media_id or local file_path; no dashboard. Explicit original_content and current board privacy required. PUBLIC needs confirm_publication; SECRET needs boards/pins read_secret and write_secret scopes. No ad or delivery change. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_create_keywords
ChatGPTCreate up to 100 keywords on a snapshot-bound owned parent. Accounts/campaigns accept only negatives; positive group keywords require a paused group or campaign under paused_creation. No keyword bid input: native bids are deprecated. Partial receipts retain IDs and are never retried. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_create_local_inventory
ChatGPTCREATE local item/store pairs with fresh context_hash. Prices stay native strings. UPDATE preserves omitted attributes; UPSERT is full replacement. Returns processing receipt, not publication success. Batch arguments stay private; the agent applies identical arguments. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_create_local_stores
ChatGPTCreate up to100 physical stores with native location metadata and fresh context_hash. Existing store codes cannot be overwritten. Can affect catalog ads; verifies scoped native configuration after apply, without activation or a native atomic absence guarantee. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_create_product_group
ChatGPTCreate a feed-based retail or catalog-based retail/hotel/creative-assets product group from exact context_hash. Native eligibility remains authoritative; independent configuration readback does not prove matched inventory or Pin publication. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_create_video_pin
ChatGPTCreate original Pin content from succeeded native video and an owned board; cover image uses explicit keyframe seconds. Requires boards/pins scopes, including read_secret/write_secret for SECRET content. Binds current visibility; PUBLIC requires confirm_publication. No advertiser ad is created. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_customer_lists
ChatGPTRead selected advertiser customer-list metadata, counts, processing status and snapshots with pagination. Never returns records or native exception contents.
pinterest_delete_catalog_items
ChatGPTDELETE one market's catalog items using fresh context_hash, explicit catalog and native async batches. Read schema before attributes. UPDATE preserves omitted fields; UPSERT is full replacement; DELETE affects all sources. Returns scoped receipt, not item/publication success. Batch arguments stay private; the agent applies identical arguments. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_delete_empty_board
ChatGPTPermanently remove an owned SECRET non-ad-only board after snapshot and known-zero Pins/collaborators/followers plus empty native Pin/section checks. Rejects populated or unknown state; no cascade workflow. Confirm deletion and stop concurrent board writers; Pinterest has no atomic empty conditional delete. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_delete_feed
ChatGPTPermanently delete an owned feed with exact snapshot and explicit deletion confirmation. No restore endpoint is exposed; review product/ad dependencies. Native deletion is reconciled before reporting success. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_delete_local_inventory
ChatGPTDELETE local item/store pairs with fresh context_hash. Prices stay native strings. UPDATE preserves omitted attributes; UPSERT is full replacement. Returns processing receipt, not publication success. Batch arguments stay private; the agent applies identical arguments. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_delete_local_stores
ChatGPTPermanently delete exact owned store IDs with current name/code confirmations. Requires complete filtered absence after native deletion. May affect inventory and ads; no exposed restore endpoint or automatic replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_delete_pin
ChatGPTPermanently delete an owned, explicitly never-promoted original Pin after matching its current snapshot. Rejects promoted or unknown usage; does not delete project source media. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_delete_product_group
ChatGPTPermanently delete one owned editable product group using exact current name/context_hash and explicit confirmations. Can affect existing ads; source items stay in the catalog. Requires complete native filtered absence after deletion; no replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_event_quality
ChatGPTRead Pinterest’s native conversion-event quality diagnostics for explicit lookback/source filters. No derived score or delivery change.
pinterest_feed_item_issues
ChatGPTRead sampled item errors/warnings after verifying processing-result membership in this feed. Up to20 affected items per code; not a complete product inventory.
pinterest_feed_processing_results
ChatGPTRead feed processing status, native product counts and diagnostics with bookmarks. Verifies feed ownership; ingestion acceptance is not product readiness.
pinterest_feeds
ChatGPTList one advertiser-owned catalog’s feeds and configuration snapshots. Native bookmarks; source paths/query values and feed credentials stay hidden.
pinterest_get_audience
ChatGPTRead an owned audience, rule, native processing status and snapshot, with read-only record view. Size/status can change independently; ownership must be explicit.
pinterest_get_board
ChatGPTRead one advertiser-owned board, native visibility/counts and copy snapshot with a guarded edit widget. Public boards require boards:read; secret boards also need boards:read_secret. No Pins are fetched or changed.
pinterest_get_catalog
ChatGPTFind an exact owned catalog via the native scoped finder (bounded 10,000 rows; Pinterest has no catalog GET-by-ID endpoint).
pinterest_get_conversion_tag
ChatGPTRead one advertiser-owned conversion tag by ID. Code snippets are returned as text only.
pinterest_get_customer_list
ChatGPTRead an explicitly owned customer-list source and snapshot including batch counters. Matching is asynchronous; fewer than100 Pinterest accounts cannot serve. No source identifiers are returned.
pinterest_get_entity
ChatGPTRead a campaign, ad group or ad by ID through the native resource endpoint, verifying advertiser and parent ownership.
pinterest_get_feed
ChatGPTVerify selected catalog membership and read current feed configuration/snapshot_hash. Authentication values and full source URLs are never returned.
pinterest_get_keyword
ChatGPTFind an exact keyword in one owned parent, with a current snapshot. Native API has no GET-by-keyword-ID; lookup is bounded to 10,000 rows. Archived keywords disappear and cannot be safely unarchived here.
pinterest_get_media_upload
ChatGPTRead native video upload processing. The credential-global media library must match the selected advertiser owner; requires pins:read and user_accounts:read. Never assumes an upload is ready.
pinterest_get_pin
ChatGPTView exact original Pin, owned board visibility and snapshot hash. Owned never-promoted Pins expose guarded copy-edit actions. This is separate from advertiser ad settings.
pinterest_get_product_group
ChatGPTRead one product group after advertiser-owner catalog verification. Native catalog/type/ID must match; automatic retail/hotel groups remain read-only. Returns snapshot_hash for inspection.
pinterest_ingest_feed
ChatGPTRequest processing for an owned feed with current snapshot and explicit source/publication confirmations. This can create/update product Pins. Partner-only endpoint; returns native job status, never retries and never activates campaigns. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_keyword_context
ChatGPTRead an explicit account/campaign/ad-group keyword parent and its snapshot. Account scope means account exclusions only, not all campaign/group keywords. Keywords have no pause flag; bids are deprecated.
pinterest_keyword_metrics
ChatGPTRead native search-frequency ranges for up to 100 keywords in CA, GB, US, IE, AU or NZ. Other markets are unavailable. Keeps values such as 5M+ as strings; no account-performance, bid or delivery change.
pinterest_keywords
ChatGPTList one verified parent’s native keywords, copy snapshots and guarded archive actions. Native bookmark pagination; UNARCHIVED is keyword state, not delivery. Account scope excludes campaign/ad-group keywords.
pinterest_list_campaigns
ChatGPTList Pinterest campaigns, including archived and draft entities.
pinterest_local_inventory
ChatGPTRead item/store pairs in a selected RETAIL catalog using native POST query. Supply store_id to verify the current store_code. Pages only requested pairs; unknown/missing rows do not prove absence and private ad links are fingerprinted.
pinterest_local_inventory_batch_status
ChatGPTRead scoped supplemental batch status using an Adport-signed receipt and current catalog ownership. Preserves per-store failures and missing results; overall COMPLETED is not every-pair success.
pinterest_local_inventory_context
ChatGPTValidate exact CREATE/UPDATE/UPSERT/DELETE operations against current owned stores and local inventory. Returns context_hash binding advertiser/catalog/store metadata, pair identity, project and request. Missing rows require explicit acknowledgement; no write occurs.
pinterest_local_store_context
ChatGPTRead fresh local-store create/update/delete context. Checks catalog ownership, complete store-code uniqueness/capacity, selected stores and exact removal names/codes. Returns context_hash; writes recheck it.
pinterest_local_stores
ChatGPTPage local stores in an explicit advertiser-owned RETAIL catalog. Optional store_ids map to native ids CSV. Opaque cursor binds selection; missing native bookmarks leave completeness unknown.
pinterest_measurement_context
ChatGPTRead advertiser identity, conversion tags and a stable snapshot_hash for guarded measurement writes.
pinterest_pins
ChatGPTView original Pinterest Pin copy/media for this advertiser owner or one owned board. Native bookmark pagination; public boards/Pins need boards:read and pins:read; secret content also needs their read_secret scopes. No dashboard.
pinterest_product_group_context
ChatGPTVerify exact create/update/delete selection, current catalog/feed configuration and transitive filter references. Returns context_hash; rechecks before apply. Use filter_schema before authoring filters. Creates no products, Pins, ads or permissions.
pinterest_product_group_counts
ChatGPTRead native counts for an owned product group with catalog-type validation. Counts are a separate observation, not frozen membership or proof of ad eligibility.
pinterest_product_group_filter_schema
ChatGPTDiscover native RETAIL/HOTEL/CREATIVE_ASSETS filter fields and exact criteria/enums on demand. Adport bounds: 32 clauses, 100 values, 1024 characters per value, 256 KiB filters. Empty non-retail selections require explicit confirmation.
pinterest_product_group_products
ChatGPTPage native product/Pin metadata for one owned product group. Cursor binds its configuration snapshot; cards append without resetting scroll. Preserves source IDs and native fields without inventing previews or publication state.
pinterest_product_groups
ChatGPTPage product groups in an exact advertiser-owned catalog, optionally one retail feed or selected IDs. Preserves native mode/type and snapshot_hash. Cursors bind account/catalog/selection; missing native bookmarks leave completeness unknown.
pinterest_reconcile_catalog_item_batch
ChatGPTIndependently re-read receipt-bound item IDs after native processing, verify requested fields and UPDATE preservation. Unknown/error item reads never certify deletion. Keeps native status, configuration checks and Pin/ad readiness separate; no replay.
pinterest_reconcile_local_inventory_batch
ChatGPTRead receipt-bound item/store pairs after native processing, checking requested fields and omitted UPDATE configuration. Native errors/missing pairs never independently prove deletion; source links stay private, and no write is replayed.
pinterest_remove_audience
ChatGPTRequest native permanent audience REMOVE only after snapshot-bound complete usage/sharing scans find no references. Requires confirm_permanent_removal; does not delete a customer-list container. No atomic provider usage freeze. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_replace_audience_rule
ChatGPTReplace a complete audience rule of the SAME type after matching configuration and complete usage context. Source ownership is reverified; shared rules are blocked. Existing linked ad groups can be affected. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_send_conversion_events
ChatGPTSend 1–1000 conversion events using expected_context_hash. Defaults test=true; all applies send data. Requires data-rights confirmation; live requires confirm_live_events. Use stable event IDs, prehashed SHA-256 matching fields and explicit currency with decimal values. Per-index outcomes; no automatic retry. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_set_ad_group_bidding
ChatGPTSet advertiser ad-group bids/strategy with current-value micro policy checks. TARGET_AVG is a monetary bid target, not a currency ratio. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_set_ad_group_budget
ChatGPTSet an existing non-CBO ad-group budget in integer micros, preserving DAILY/LIFETIME type and enforcing current-value policy checks. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_set_ad_group_status
ChatGPTPause or activate an account-owned child entity after checking its parent hierarchy. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_set_ad_status
ChatGPTPause or activate an account-owned child entity after checking its parent hierarchy. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_set_budget
ChatGPTChange an existing Pinterest CBO campaign budget in micros, preserving its daily/lifetime type. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
pinterest_set_campaign_daily_budget
ChatGPTSet CBO fixed/average daily mode and optional configured micro amount using fresh context_hash. Average mode requires variable-spend/reset acknowledgements. Shared caps check the configured amount; native readback preserves status and omitted settings, without a daily-delivery ceiling claim. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_set_campaign_status
ChatGPTPause or activate an existing Pinterest campaign. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
pinterest_targeting_options
ChatGPTRead native targeting resources for the selected advertiser; returns provider codes and labels.
pinterest_update_ad
ChatGPTPatch the verified advertiser ad’s name/destination/tracking fields. Pin replacement is allowed only for DRAFT ads; existing Pins remain unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_update_ad_group
ChatGPTPatch supplied ad-group name, schedule, targeting or optimization fields. Omitted targeting dimensions remain unchanged; supplied arrays replace their previous values. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_update_audience
ChatGPTEdit supplied owned-audience name/description after matching its snapshot. Null clears description; omitted copy, rules, source type and membership remain unchanged. Shared audiences are rejected. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_update_board
ChatGPTEdit supplied board name/description after matching its copy/owner/privacy snapshot. Omitted fields, privacy, Pins, sections and delivery are preserved; null clears description. Ad-only names cannot be changed. Uses boards read/write and corresponding secret scopes for SECRET boards. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_update_catalog_item_copy
ChatGPTEdit catalog item title/name or description from a current item snapshot_hash, preserving other fields. Native batch receipt and Processing pending remain separate from independent readback or publication. Uses the normal exact preview/apply gate. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_update_catalog_items
ChatGPTUPDATE one market's catalog items using fresh context_hash, explicit catalog and native async batches. Read schema before attributes. UPDATE preserves omitted fields; UPSERT is full replacement; DELETE affects all sources. Returns scoped receipt, not item/publication success. Batch arguments stay private; the agent applies identical arguments. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_update_customer_list_records
ChatGPTADD/REMOVE up to10,000 SHA-256 records on an owned, snapshot-bound customer list. Confirms data rights, preserves list type and matching mode, and previews count/digest only. Native errors cannot expose identifiers. No automatic retry. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_update_feed
ChatGPTUpdate selected settings on an owned Pinterest catalog feed. A replacement source must be a public HTTPS URL. Source changes require access confirmation. Active feeds require confirmation that processing can publish product Pins. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_update_local_inventory
ChatGPTUPDATE local item/store pairs with fresh context_hash. Prices stay native strings. UPDATE preserves omitted attributes; UPSERT is full replacement. Returns processing receipt, not publication success. Batch arguments stay private; the agent applies identical arguments. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_update_local_stores
ChatGPTPatch owned local stores using fresh context_hash, preserving omitted configuration. Store-code changes require acknowledgement and current unique-code proof; code swaps are blocked. Native inventory migration is not promised. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_update_pin
ChatGPTEdit supplied title, description, alt text or link of an owned, never-promoted original Pin. Omitted copy, media and board are preserved; null clears a supplied field. Snapshot binds current copy/privacy/promotion. Changes existing organic content; SECRET needs boards/pins secret scopes. Native beta access required. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_update_product_group
ChatGPTEdit selected product-group name/description/filter and supported retail locale/country fields using exact context_hash and live-effects acknowledgement. Revalidates references and preserves omitted native settings; automatic groups are read-only. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_upload_video
ChatGPTRegister and upload SHA-bound MP4 to Pinterest, without creating a Pin or ad. Native media is token-owner scoped, so advertiser owner must match; requires pins read/write and user_accounts:read. Read returned ID processing before create_video_pin. Unknown outcomes are not retried. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_upsert_catalog_items
ChatGPTUPSERT one market's catalog items using fresh context_hash, explicit catalog and native async batches. Read schema before attributes. UPDATE preserves omitted fields; UPSERT is full replacement; DELETE affects all sources. Returns scoped receipt, not item/publication success. Batch arguments stay private; the agent applies identical arguments. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
pinterest_upsert_local_inventory
ChatGPTUPSERT local item/store pairs with fresh context_hash. Prices stay native strings. UPDATE preserves omitted attributes; UPSERT is full replacement. Returns processing receipt, not publication success. Batch arguments stay private; the agent applies identical arguments. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
projects_list
ChatGPTList projects authorized for this connection and their connected platforms. Use a returned project id as project_id on other tools.
recommendation_dismiss
ChatGPTDismiss a finding (it will not be re-opened by future audit runs).
recommendations_list
ChatGPTList persisted audit findings/recommendations (default: open ones), most severe first.
reddit_account_context
ChatGPTRead the selected ad account’s basic metadata and parent Business ID. Business/catalog enumeration and catalog access require separate explicit project grants.
reddit_ad_groups
ChatGPTRead account ad-group configuration, targeting, bids and budgets with native pagination.
reddit_ads
ChatGPTView account ad settings and referenced structured-post copy/media. Creative edit actions stage a separate copy; original posts remain unchanged.
reddit_archive_entity
ChatGPTArchive a verified campaign/ad group/ad using native PATCH; this changes delivery without inventing an unsupported DELETE endpoint. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_asset_upload_status
ChatGPTRead native asset-processing status using the account-bound resource_receipt from its approved upload.
reddit_assets
ChatGPTView an associated profile’s native image/video/headline/CTA asset library and processing readiness.
reddit_audiences
ChatGPTList custom audiences available to the account, including ownership, type, size and processing readiness.
reddit_campaigns
ChatGPTList Reddit campaigns and their native configured/effective status, CBO budget, objective, and funding instrument.
reddit_catalog_access
ChatGPTList this project/ad-account’s explicit catalog and creation grants. Does not enumerate native Business catalogs or infer Business authority from enabled advertiser access.
reddit_catalog_creation_context
ChatGPTRead exact owner creation-delegation and selected-account Pixel snapshots for a new Business catalog. Verifies selected Business and optional event-source IDs. No existing catalog enumeration or automatic authority expansion.
reddit_catalog_event_source_context
ChatGPTRead current catalog configuration and verify selected Pixel IDs under this ad account before replacing all catalog event sources. Empty explicitly clears them. Shared effects require a separate guarded preview.
reddit_catalog_feeds
ChatGPTBrowse feeds in one explicitly granted Business catalog. Native lists are unpaged; Adport bounds to5,000 and snapshot-pages locally. Source paths, query values and authentication stay private.
reddit_catalog_import_issues
ChatGPTRead one catalog import’s issues after proving import membership in the selected catalog within 10,000 rows. Global/foreign IDs are rejected; each page rechecks current catalog access.
reddit_catalog_import_report
ChatGPTObtain a temporary native report download URL only after current catalog/import membership proof. Does not fetch it or forward Reddit credentials. Missing/expired reports are not clean diagnostics.
reddit_catalog_imports
ChatGPTPage import history for one explicitly granted catalog, with repeated feed IDs and native status filters. Processing counts and missing fields remain native snapshots.
reddit_catalog_product_context
ChatGPTRead up to 100 exact external SKUs in one granted Business catalog, exhausting scoped native pagination. Returns a selection_hash and present/absent state for manual product changes; not a global inventory.
reddit_catalog_product_set_products
ChatGPTPage products matching one independently verified catalog/set. Rechecks catalog and set scope on every page; membership can change between pages.
reddit_catalog_product_sets
ChatGPTPage through product sets in one explicitly granted Business catalog. Verifies each native parent; no global set enumeration.
reddit_catalog_products
ChatGPTPage catalog products and native approval/issues through one exact catalog grant. Preserves repeated ID query parameters and opaque SKUs. Embeds Reddit-hosted native previews only.
reddit_create_ad
ChatGPTCreate a paused ad from an account-owned ad group and an eligible post; verifies referenced profile/content before creation. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_create_ad_group
ChatGPTCreate a MANUAL ad group, paused by policy. Non-CBO groups require an explicit budget and bid settings; pass null bid fields only to inherit CBO settings. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_create_campaign
ChatGPTCreate a Reddit campaign through API v3. Campaigns are forced PAUSED. CBO budgets and spend caps are integer micros. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_create_catalog
ChatGPTCreate an empty catalog under exact owner Business delegation using fresh access/Pixel hashes. Verifies native ID/configuration then adopts only the verified new ID for project write access. No products, ads, spend or events; uncertain results are never replayed. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_create_catalog_feed
ChatGPTCreate a feed from a public HTTPS URL in the selected Reddit catalog. Choose REPLACE or UPDATE and confirm processing and effects on existing products and ads. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_create_catalog_product_set
ChatGPTCreate a shared catalog product set with a documented filter JSON string and fresh catalog hash. Uses normal approval and independent ID/catalog/configuration readback; creates no ads or spend. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_create_catalog_products
ChatGPTCreate up to 100 absent SKUs through native batch upsert with fresh selection_hash and complete product copy/price/URLs. Rechecks absence, uses normal approval and independent readback. Native concurrent upsert races and feed overwrites remain possible. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_create_customer_audience
ChatGPTCreate an empty customer-list audience. Membership upload is a separate approval with pre-hashed identifiers. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_create_engagement_audience
ChatGPTCreate engagement retargeting from verified account-owned campaigns with explicit events/window settings. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_create_pixel_audience
ChatGPTCreate website retargeting from one account-available Pixel and explicit event/window settings. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_create_post
ChatGPTCreate an async structured advertising-post job from owned ready assets. Comments default off. Ad creation and activation remain separate approvals. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_create_saved_audience
ChatGPTCreate reusable native REDDIT_AUDIENCE targeting, with expansion explicitly off unless supplied. Audience references must be account-available. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_create_text_asset
ChatGPTCreate a headline or CTA asset through the native asset-processing API. Does not create or activate an ad. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_delete_asset
ChatGPTPermanently remove an asset from an account-associated profile library. Review shared profile usage before approval. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_delete_audience
ChatGPTPermanently delete an account-owned custom audience. Ads using it can lose eligibility; shared foreign audiences cannot be deleted. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_delete_catalog
ChatGPTPermanently delete one exact writable catalog using its current hash, exact name and shared/contents acknowledgement. Verifies native acknowledgement and exact lookup absence; other errors remain errors. Contents are not frozen. No restore or automatic replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_delete_catalog_feed
ChatGPTPermanently delete an exact writable catalog/feed using its current configuration_hash and shared/deletion acknowledgements. Checks native204 acknowledgement and exactGET404. Other errors remain errors; imported products/ads are not frozen or automatically removed. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_delete_catalog_product_set
ChatGPTPermanently delete an exact shared product-set definition using current hash/name and acknowledgements. Verifies native acknowledgement and exact GET404; dependent membership/ads are not frozen and errors are not absence. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_delete_catalog_products
ChatGPTPermanently delete up to 100 exact present external SKUs with selection_hash and explicit acknowledgement. Verifies per-SKU native receipts and exhausted absence readback. Feeds can recreate products; internal Reddit IDs are not SKUs. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_delete_saved_audience
ChatGPTMark an owned saved audience DELETED using native PATCH. Reports active ad-group usage before approval. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_get_audience
ChatGPTRead one custom audience already available to the selected account. Availability does not grant editing rights to a shared audience.
reddit_get_catalog
ChatGPTRead one explicitly granted Business catalog, native counts and configuration_hash. Verifies native catalog/Business IDs; missing fields remain unavailable. No dependent product/ad inventory claim.
reddit_get_catalog_feed
ChatGPTRead one exact catalog/feed with safe source origin/fingerprint, reported schedule and configuration_hash. Missing schedule fields remain unavailable; authentication values are never returned.
reddit_get_catalog_product_set
ChatGPTRead an exact native catalog/set, filter and configuration_hash. Product counts are native snapshots; absent fields remain unavailable.
reddit_get_entity
ChatGPTRead a native campaign, ad group or ad by ID and verify the selected account and parent hierarchy.
reddit_get_saved_audience
ChatGPTRead an account-owned saved audience and its native targeting.
reddit_import_asset_url
ChatGPTAsk Reddit to import an existing HTTPS image/video URL. Approval binds the URL, not mutable remote bytes; prefer reddit_upload_asset for exact project files. No file is fetched by Adport. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_pixel_last_fired
ChatGPTRead native last-fired timestamps after proving the Pixel is available to this account. Missing timestamps remain unavailable.
reddit_pixels
ChatGPTList Pixels already available to the selected ad account. Current v3 has no public Pixel creation/update endpoint.
reddit_post_job
ChatGPTRead a created post job using its account-bound resource_receipt. Rechecks current profile association; arbitrary global job IDs are rejected.
reddit_posts
ChatGPTView structured-post copy/media belonging to an account-associated profile, including unattached posts staged for review.
reddit_profiles
ChatGPTList profiles already associated with this ad account, including native profile IDs and Reddit user IDs.
reddit_rename_asset
ChatGPTRename an asset in an account-associated profile library; the name is shared by users of that profile. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_rename_catalog
ChatGPTRename one writable shared Business catalog using its configuration_hash and shared-effects acknowledgement. Independently checks preserved defaults/event sources. No automatic replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_report
ChatGPTQuery Reddit Ads API v3 reporting directly. Spend/CPC/CPM use micros; conversion TOTAL_VALUE fields use cents. Missing metrics remain unavailable.
reddit_saved_audiences
ChatGPTList reusable saved targeting audiences and their native readiness/usage counts.
reddit_send_conversion_events
ChatGPTSubmit up to 1,000 deduplicated events to an account-available Pixel. Requires existing adsconversions scope. TEST needs Events Manager test_id; explicit LIVE affects measurement. Customer keys must be pre-hashed. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_set_ad_group_bidding
ChatGPTChange a non-CBO strategy/monetary bid in integer micros. Removing an existing monetary cap is rejected until policy can represent an unbounded change. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_set_ad_group_budget
ChatGPTChange a non-CBO ad-group budget in integer micros using the current value; preserves its daily/lifetime type. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_set_ad_group_status
ChatGPTPause or activate a child after verifying its entire account/parent hierarchy. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_set_ad_status
ChatGPTPause or activate a child after verifying its entire account/parent hierarchy. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_set_budget
ChatGPTChange a Reddit CBO campaign goal_value in integer micros, with current-value lookup and policy checks. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_set_campaign_status
ChatGPTActivate or pause a Reddit campaign after verifying ad-account ownership. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_set_catalog_event_sources
ChatGPTReplace all event-source Pixel IDs using fresh catalog/source-context hashes and shared/measurement-effects acknowledgement. Empty explicitly clears. Verifies selected-account availability and preserved configuration; sends no events and never replays. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_set_catalog_feed_schedule_status
ChatGPTPause or resume one verified feed schedule with a current hash and shared/automatic-processing acknowledgements. Uses the opposite known pause state and preserves reported timing/source/mode. Does not cancel or undo an existing import. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_stage_post_copy
ChatGPTStage a new structured-post copy for one verified ad with supplied headline/body edits. Does not mutate the original post or attach the result to the ad. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_targeting_options
ChatGPTRead native carriers, communities/search, devices, geolocations, interests, languages and third-party audience choices.
reddit_update_ad
ChatGPTPatch name, destination or post reference on one verified ad. A post replacement preserves configured status and can trigger review. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_update_ad_group
ChatGPTPatch an owned ad group’s supplied name/start/end fields while preserving omitted settings. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_update_audience_users
ChatGPTAdd/remove at most 2,500 pre-hashed customer rows from an owned CUSTOMER_LIST audience. Preview shows count and digest, not identifiers. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_update_catalog_feed
ChatGPTUpdate selected Reddit feed settings using its current configuration hash. A replacement source must be a public HTTPS URL. Source, mode and schedule changes require acknowledging processing and can affect existing products and ads. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_update_catalog_product_set
ChatGPTUpdate selected name/filter fields using the exact set configuration_hash and shared-effects acknowledgement. A filter replaces matching rules; omitted configuration is independently checked. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_update_catalog_products
ChatGPTUpdate selected fields on up to 100 existing external SKUs with current selection_hash. Merges all known writable fields, refuses unknown configuration, verifies complete readback and reports uncertain/partial outcomes without replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_update_saved_audience
ChatGPTChange name or supplied saved targeting dimensions, preserving omitted settings. Changes can affect all ad groups using it. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_update_targeting
ChatGPTEdit supplied targeting dimensions, preserving omitted dimensions and replacing supplied arrays. Explicit expansion settings are retained. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
reddit_upload_asset
ChatGPTStage checksum-bound project image/video bytes for Reddit’s URL-pull asset processor. Requires a hosted immutable media resolver; private source URLs are omitted from previews. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
report
ChatGPTCross-platform performance report with normalized metrics (spend, clicks, conversions, ROAS, ...). Rows are capped by limit; the response says when it truncated. Use summary.groups for currency-separated totals and spend-weighted ROAS; never average row ratios or combine currencies. Null metrics are unavailable. Use granularity=day for real daily observations, up to 31 days; this makes one report read per provider per day.
snapchat_add_audience_users
ChatGPTAdd up to 10000 pre-normalized lowercase SHA-256 identifiers to an owned FIRST_PARTY audience. Preview shows counts/digest, never identifiers. Raw personal data is rejected. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_ads
ChatGPTRead ad settings, creative references and configured/review/delivery statuses.
snapchat_adsquads
ChatGPTRead ad-squad targeting, schedules, budgets and bids with native cursor pagination.
snapchat_audience_size
ChatGPTRead the non-binding audience size for an account-owned ad squad using native audience_size_v2.
snapchat_audiences
ChatGPTRead selected-account audience segment metadata and readiness; does not retrieve individual users.
snapchat_clear_audience_users
ChatGPTRemove all members from an owned FIRST_PARTY audience. This cannot be undone without uploading the identifiers again. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_create_ad
ChatGPTCreate a paused ad linked to an account-owned creative and ad squad; validates native creative/ad format compatibility. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_create_adsquad
ChatGPTCreate an account-owned campaign’s ad squad, paused by policy. Budgets and bids are integer micros; explicit targeting is required. Deprecated MIN_ROAS is excluded. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_create_campaign
ChatGPTCreate a Snapchat campaign, paused by default. Budget fields use integer micro-currency. Preview is local, not server validation. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_create_creative
ChatGPTCreate a reusable Snap, web, app, deep-link, story or lens-attachment creative from owned ready media and an already-shared Public Profile. Does not create or activate ads. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_create_custom_conversion
ChatGPTCreate a typed native Pixel/App custom conversion rule after verifying source access. Does not transmit a conversion event. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_create_customer_audience
ChatGPTCreate an empty FIRST_PARTY audience. No customer records are uploaded; 9999 means lifetime retention. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_create_engagement_audience
ChatGPTCreate an audience from verified ad-account/campaign/ad-squad engagements. Native retention is 395 days; source entries are ORed. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_create_lookalike
ChatGPTCreate a lookalike from an owned first-party or profile-engagement seed using native countries, similarity mode and retention. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_create_media
ChatGPTCreate an account-owned IMAGE/VIDEO media container. No bytes are uploaded until a separate checksum-bound upload is approved. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_create_mobile_audience
ChatGPTCreate a mobile-event audience from an already-available Snap App ID with historical-event prefill. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_create_profile_audience
ChatGPTCreate a subscribers/engagers audience from an already-shared Public Profile, with up to 180 days retention. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_create_website_audience
ChatGPTCreate a website-event audience from an account-available Pixel. Snap requires historical-event prefill; does not install tracking or send events. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_creatives
ChatGPTView selected-account creative copy and native image/video media. Shared creative copy edits affect all linked ads and trigger review.
snapchat_custom_conversions
ChatGPTRead native custom conversion definitions for an account-available Pixel or Snap App.
snapchat_delete_audience
ChatGPTPermanently delete an owned audience. Existing targeting references can stop matching; use the separate preview/apply gate. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_delete_custom_conversion
ChatGPTPermanently delete a custom conversion after verifying access to its Pixel/App source. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_delete_entity
ChatGPTPermanently delete a verified campaign, ad squad or ad. Prefer pausing for reversible delivery changes. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_get_audience
ChatGPTRead an account-owned audience by ID, including native seed/specification and readiness fields.
snapchat_get_entity
ChatGPTRead one campaign, ad squad, ad, creative or media item and verify its account and parent hierarchy.
snapchat_list_campaigns
ChatGPTList Snapchat campaigns in the selected ad account.
snapchat_media
ChatGPTList selected-account media metadata, upload readiness and native preview/download links.
snapchat_mobile_apps
ChatGPTList Snap App IDs already shared with the selected account; does not create or widen sharing.
snapchat_pixels
ChatGPTRead pixels already available to this account. Pixel creation is done in Snap Ads Manager; this tool does not install tracking or send events.
snapchat_public_profiles
ChatGPTList Public Profile IDs already shared with this ad account. Does not create sharing policies or widen access.
snapchat_remove_audience_users
ChatGPTRemove up to 10000 SHA-256 identifiers from an owned FIRST_PARTY audience. Membership changes affect ads targeting the segment. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_rename_pixel
ChatGPTRename an account-owned Pixel. Shared pixels from other accounts cannot be renamed through this account. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_set_ad_status
ChatGPTPause or activate an account-owned child after checking its parent hierarchy. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_set_adsquad_bidding
ChatGPTChange bid strategy and/or monetary bid in integer micros. Preserves omitted settings and checks current monetary deltas. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_set_adsquad_budget
ChatGPTChange the existing daily/lifetime ad-squad budget in integer micros, with current-value policy checks. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_set_adsquad_measurement
ChatGPTAssociate existing account-available Pixel/Snap App IDs with a verified ad squad using partial JSON Patch. Does not install code or send events. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_set_adsquad_status
ChatGPTPause or activate an account-owned child after checking its parent hierarchy. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_set_budget
ChatGPTSet a Snapchat campaign daily budget or lifetime cap in integer micros; reads the existing value for policy checks. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_set_campaign_status
ChatGPTPause or activate a Snapchat campaign after verifying account ownership. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_targeting_options
ChatGPTRead native geo, demographic, device and interest choices. Country-specific dimensions require country_code.
snapchat_update_ad
ChatGPTPatch an account-owned ad’s name, schedule or tracking tags. Use a new paused ad to select a different creative. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_update_adsquad
ChatGPTPatch supplied name, schedule, placement or brand-safety fields without resetting omitted settings. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_update_audience
ChatGPTUpdate an owned audience’s metadata/retention while preserving omitted mutable fields. Does not replace its event or seed specification. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_update_creative
ChatGPTPatch supplied creative copy, CTA or attachment fields. All ads sharing this creative are affected and reviewed. Top Snap replacement is limited to unused creatives. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_update_targeting
ChatGPTPatch only supplied targeting dimensions; arrays replace their previous dimension. Targeting edits trigger review and can briefly pause delivery. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
snapchat_upload_media
ChatGPTUpload SHA-256-bound image/video bytes to a PENDING_UPLOAD media container. Uses native multipart/chunk paths with exact media ownership checks. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_ad_categories
ChatGPTSearch Spotify’s live advertiser-category codes for draft ad sets.
spotify_ad_sets
ChatGPTRead published ad-set targeting, bidding, budgets and delivery, with pagination.
spotify_ads
ChatGPTView published or draft ad copy and image/video/audio assets. Drafts include guarded copy-edit actions; publication remains separate.
spotify_assets
ChatGPTView Spotify account image/video/audio assets and processing status with pagination.
spotify_audience_datasets
ChatGPTRead eligible account datasets and available web events for audience creation. Returns native pagination limits.
spotify_audience_estimate
ChatGPTGet a non-binding audience/delivery estimate using a read-only POST. Native micro amounts and explicit placements are required; no audience or ad is created.
spotify_audiences
ChatGPTRead existing account-owned custom/lookalike audiences with native filters and pagination. Does not upload customer records.
spotify_bid_estimate
ChatGPTGet a non-binding native bid estimate with explicit targeting/placements. No bids or delivery settings are changed.
spotify_capi_credentials
ChatGPTList active CAPI credential IDs, creation times and private storage status for an integration shared only with this selected account. Returns snapshot hashes for mutations; never returns token values or sends events.
spotify_change_history
ChatGPTRead account change history within Spotify’s rolling180-day window. Actor details and billing rows depend on the caller’s role.
spotify_create_asset
ChatGPTCreate account-owned asset metadata for a later checksum-bound upload. No creative is attached to an ad. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_create_audience
ChatGPTCreate a web-event or ad-engagement audience from existing account-owned resources. Does not upload customer records or attach targeting to ads. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_create_campaign_draft
ChatGPTCreate an unpublished Spotify campaign draft, paused by policy. Does not publish or launch ads. Preview is local. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_create_capi_credential
ChatGPTCreate one long-lived CAPI credential and store it privately in Adport. Requires current hashes from spotify_capi_credentials and explicit access acknowledgement. No secret is returned; no events are sent. Never repeat an unconfirmed creation. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_create_capi_integration
ChatGPTCreate a CAPI connection in a new or verified existing dataset, then verify sharing with the selected account. Does not issue tokens or send events. Returns a signed receipt for partial creation recovery; never retries automatically. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_create_dataset
ChatGPTCreate a dataset from explicit account-owned integrations and source snapshots, acknowledging measurement rerouting. Independently checks each native integration’s new dataset binding and selected-account sharing. Prefer Pixel-first plus CAPI dataset_id for a shared topology. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_create_draft_ad
ChatGPTStage unpublished ad copy and existing account-owned asset IDs under a verified draft ad set. Does not publish or enable delivery. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_create_draft_ad_set
ChatGPTStage an unpublished ad set under a verified draft campaign. Monetary values are integer micros. Partial drafts are allowed; targeting requires placements and lifetime budgets require end_time. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_create_draft_from_published
ChatGPTStage a copy of an account-owned published campaign/ad set/ad without changing delivery. Refuses to overwrite an existing draft. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_create_lookalike_audience
ChatGPTCreate a lookalike from an existing account-owned seed audience. Does not upload customer records or change ad targeting. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_create_mobile_app
ChatGPTRegister native mobile measurement metadata and share the new app only with this account. Supports current MMP enums including SINGULAR. Does not install a partner SDK; link tokens are not returned. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_create_pixel
ChatGPTCreate a Pixel and verify its native dataset, then share only with the selected account. AAM defaults off; opt-in requires explicit acknowledgement. Supports existing dataset_id with its current hash. No website install or event sending. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_create_report
ChatGPTSubmit a native asynchronous CSV export job. No ad or delivery changes. Native field names are server-validated; use spotify_report_status for completion. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_created_measurement
ChatGPTReconcile the exact created resource and receipt-bound parent with current account/business access. A missing child binding requires the locked parent to independently name this exact resource. Explicit conflicts never follow another parent. Read-only; never replays a write.
spotify_dataset_diagnostics
ChatGPTRead native DAILY/HOURLY source activity for an authorized dataset. Diagnostics can lag 20 minutes; activity does not prove campaign attribution. Sends no conversion events.
spotify_datasets
ChatGPTList only datasets shared with this account. The native endpoint has no limit/offset query; returns explicit completeness rather than inventing pagination.
spotify_delete_audience
ChatGPTDelete an account-owned audience through the normal preview/apply gate. Review dependencies before applying. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_delete_draft
ChatGPTDelete only an unpublished draft. Delete child ad drafts first: parent deletion is refused while ads remain to prevent provider orphan records. Published entities remain unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_delete_draft_ad_sets
ChatGPTAtomically delete account-owned drafts through the native batch endpoint. Delete child ads before ad sets to prevent provider orphan records. Published entities remain unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_delete_draft_ads
ChatGPTAtomically delete account-owned drafts through the native batch endpoint. Delete child ads before ad sets to prevent provider orphan records. Published entities remain unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_drafts
ChatGPTList unpublished campaign, ad-set or ad drafts, with native pagination and hierarchy versions. This does not publish.
spotify_geo_targets
ChatGPTSearch native geographical targeting IDs with country/type filters and pagination.
spotify_get_ad_set
ChatGPTRead a Spotify ad set, including its budget and delivery setting.
spotify_get_asset
ChatGPTRead an account-owned asset and processing status. No ad delivery changes.
spotify_get_audience
ChatGPTRead one account-owned custom/lookalike audience and its processing status.
spotify_get_capi_integration
ChatGPTRead a CAPI connection bound to an authorized dataset. Returns configuration_hash and metadata only, never active credentials.
spotify_get_dataset
ChatGPTRead one shared dataset and its configuration_hash. An unshared approved creation requires its signed resource_receipt. Other account identities are omitted.
spotify_get_draft
ChatGPTRead an account-owned draft and verify its parent hierarchy. Use the campaign draft version for validation/publication.
spotify_get_mobile_app
ChatGPTRead one account-shared or approved-created mobile app with its configuration_hash. Native MMP link tokens are omitted.
spotify_get_pixel
ChatGPTRead the Pixel bound to an authorized dataset, including matching settings and configuration_hash. Native Pixel IDs alone do not authorize business-wide reads.
spotify_insight_report
ChatGPTRead native lifetime insights for exactly one verified published ad set, as required by the live endpoint. Missing/suppressed conversion fields remain unavailable.
spotify_list_campaigns
ChatGPTList published Spotify Ads campaigns in the selected account.
spotify_measurement_context
ChatGPTRead the selected account’s verified business and shared dataset topology. Read an individual resource before a mutation to obtain its full configuration_hash. Other account identities and business-wide inventory are excluded; no tracking or credentials are created.
spotify_measurement_sharing_status
ChatGPTReconcile sharing with the signed receipt from an approved share/unshare operation. Returns only selected-account sharing state; a status receipt does not grant content access after unsharing.
spotify_mobile_apps
ChatGPTRead mobile measurement apps shared with this account using native pagination. Link tokens and other account identities are omitted.
spotify_publish_draft
ChatGPTSpotify publishes ACTIVE even from a PAUSED draft. Blocked while paused_creation policy is enabled. Otherwise requires explicit acknowledge_active_publication=true, exact hierarchy version, budget checks and server validation. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_remove_dataset_integration
ChatGPTRemove one verified integration from a dataset. Spotify moves it to a newly created dataset; this does not delete the source or remove website code. Requires current snapshot and explicit acknowledgement; returns signed recovery context. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_rename_asset
ChatGPTRename account-owned asset metadata without replacing media or changing delivery. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_report_status
ChatGPTRead a previously submitted account export’s status and native CSV URL. Does not fetch arbitrary URLs or create a public share.
spotify_revoke_capi_credential
ChatGPTRevoke one selected CAPI credential and remove its Adport copy after native confirmation. May stop existing event publishers. Fresh hashes and explicit acknowledgement required. Also reconciles a stored copy when native revocation already completed. No automatic native retries. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_set_ad_set_delivery
ChatGPTTurn an existing Spotify ad set delivery OFF or ON. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_set_budget
ChatGPTChange a Spotify ad-set budget in integer micros, preserving its current DAILY or LIFETIME type. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_set_campaign_status
ChatGPTPause or activate an existing Spotify Ads campaign. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_set_dataset_sharing
ChatGPTShare/unshare a verified dataset only with the selected account, preserving all other shares. Requires current configuration_hash; unsharing needs measurement-effect acknowledgement. An unshared creation requires its receipt. Native readback and signed status reconciliation prevent unsafe replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_set_mobile_app_sharing
ChatGPTShare/unshare only this account’s mobile-app association using the current hash. Unsharing needs explicit measurement-effect acknowledgement; other shares are preserved and the result is independently verified. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_store_capi_credential
ChatGPTStore one selected active native CAPI credential privately in Adport without creating another token. Requires fresh credential/context hashes and explicit access acknowledgement. The token is fetched server-side and never returned. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_targeting_options
ChatGPTSearch native Spotify artist, genre, interest, language, playlist or podcast topic targeting.
spotify_update_audience
ChatGPTRename or edit the description of an account-owned audience, preserving its native type and source rules. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_update_capi_integration
ChatGPTRename an authorized CAPI connection with its current configuration_hash. Preserves dataset routing and independently verifies native readback; does not touch credentials or events. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_update_dataset
ChatGPTRename an authorized dataset with its current configuration_hash, preserving sources and sharing. Business-wide edits are rejected when another account shares the dataset or dependencies are unknown. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_update_draft_ad
ChatGPTPatch unpublished ad copy/assets/CTA. Omitted assets and CTA fields are preserved; supplied tracking arrays replace the full array. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_update_draft_ad_set
ChatGPTPatch draft ad-set targeting, schedule, budget or bids. Preserves omitted nested targeting; arrays replace supplied dimensions. Amounts use micros. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_update_draft_campaign
ChatGPTPatch only supplied draft campaign fields. Publication is separate; status changes here affect only the draft. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_update_mobile_app
ChatGPTUpdate account-owned mobile app metadata using its current configuration_hash. Sends the required native name, preserves omitted fields and independently verifies native readback. Link tokens cannot be edited or disclosed. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_update_pixel
ChatGPTUpdate a verified Pixel name/domain with its current configuration_hash. Native update cannot change AAM. Preserves matching, routing and other configuration; rejects stale or cross-account-shared configuration and independently reads back the result. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_upload_asset
ChatGPTUpload SHA-256-approved image/video/audio to a new WAITING_UPLOAD asset. Uses native chunking above20MB; Adport cap100MiB, hosted staging50MiB. Existing assets cannot be overwritten. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
spotify_validate_draft
ChatGPTValidate a specific campaign draft hierarchy version server-side without publishing. Returns native validation errors.
tiktok_ad_groups
ChatGPTRead native ad-group targeting, budgets, bidding, schedules and statuses with pagination.
tiktok_ads
ChatGPTRead native TikTok ad configuration and copy with guarded text/status edit actions. Media previews use URLs returned by TikTok.
tiktok_audience_sharing_context
ChatGPTCheck selected owned audiences, native authorization, source Admin/Operator role and selected accounts in one Business Center. Returns context_hash for SHARE or singular UNSHARE, with exact existing pairs. No access is changed.
tiktok_audience_sources
ChatGPTDiscover advertiser-scoped event sources for all nine rule-audience families. Pages apps, pixels, ad groups, stores, offline sets and exact-identity videos. Source filters and cursors stay bound; organic history has a native 500-post window.
tiktok_automated_rule_result_details
ChatGPTRead per-object results for explicit native rule/execution ID pairs. Provider errors and exact IDs are retained; no execution, notifications or budget changes.
tiktok_automated_rule_results
ChatGPTRead existing rule execution history with native filters and UTC time range. Preserves rule configuration and execution summaries; supports paging, not action execution.
tiktok_automated_rules
ChatGPTInspect existing advertiser automated rules by native status, ID/name and object dimension. Explicit page certainty and Load more; Adport limit100/page. Does not create rules or trigger actions.
tiktok_bind_catalog_event_sources
ChatGPTBind selected advertiser app/Pixel sources to a writable catalog using fresh context hashes and shared/measurement-effects acknowledgement. Can affect existing catalog matching/ads. Rechecks sources and all bindings; no tracking installation, event sending or automatic replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_campaigns
ChatGPTList TikTok campaigns (id, name, operation_status ENABLE/DISABLE, budget, budget_mode, objective).
tiktok_catalog_access
ChatGPTList only this project/account’s explicit Business Center catalog grants. Advertiser access alone grants no catalog access. No native Business Center inventory is enumerated.
tiktok_catalog_creation_context
ChatGPTRead an owner-delegated creation grant hash and available regions for one advertiser/Business Center. Covers all ten catalog types; native allowlists and currency combinations remain authoritative. No existing catalogs are enumerated or granted.
tiktok_catalog_event_source_apps
ChatGPTDiscover apps under the selected advertiser for catalog source selection. Native app_id differs from platform/TikTok App IDs. Safe summaries only; local snapshot paging over the unpaged native response. No tracking URLs/tokens or eligibility guarantee.
tiktok_catalog_event_source_context
ChatGPTVerify one app_id, pixel_code or both under the selected advertiser and read catalog/binding/source hashes for bind or unbind. Bind checks Pixel catalog availability; unbind checks existing membership. No events or writes.
tiktok_catalog_event_sources
ChatGPTRead app/Pixel bindings in an explicitly granted Business Center catalog. Returns binding/catalog hashes. Native list is unpaged; bounded snapshot pages preserve scope. Catalog-level bindings do not establish selected-advertiser source ownership.
tiktok_catalog_feed_log
ChatGPTRead the latest 10 native processing operations for an exact verified feed. Shows status, counts and timestamps only; not full history or proof of catalog ad eligibility.
tiktok_catalog_feeds
ChatGPTBrowse feeds in one explicitly granted catalog, with safe source fingerprints and configuration_hash. Native lists are unpaged; Adport bounds to 5,000 and snapshot-pages locally. Credentials, source paths and query values stay hidden.
tiktok_catalog_product_context
ChatGPTRead exact native product IDs, safe editable configuration and products_hash for JSON edits/removal. Verifies catalog/feed and every selected ID; URL origins/fingerprints only. This is selected configuration, not complete catalog inventory or proof of feed membership.
tiktok_catalog_product_log
ChatGPTRead one product import task after verifying its catalog/feed. Native processing state, counts and bounded diagnostic field counts; no free-form error text or download capabilities. SUCCESS is not ad eligibility. Requires the feed_log_id returned on import.
tiktok_catalog_product_schema
ChatGPTRead the official structural product schema for this granted catalog’s native type and upload/update operation. Covers all ten catalog types. Native semantic requirements still apply; no products or ads are changed.
tiktok_catalog_products
ChatGPTBrowse product/media summaries in an explicitly granted catalog. Native product-ID or ECOM SKU filters, exact string IDs and page navigation. At most100/page and10,000 accessible matches; missing pagination stays unknown. Compact view, not full editable configuration.
tiktok_catalog_video_import_context
ChatGPTInspect a checksum-bound project CSV for catalog videos and verify every referenced SKU is AVAILABLE for ad creation. Returns catalog/association hashes for upload. Up to 5,000 rows/distinct SKUs and 20 SKUs/video; source URLs stay private. No upload or media-eligibility claim.
tiktok_catalog_video_log
ChatGPTRead one catalog-video handling task with exact catalog binding. Preserves native processing states/counts and bounded diagnostic field counts. Does not certify video extraction, ad eligibility or advertiser sync; source links/downloads and free-form diagnostics stay hidden.
tiktok_catalog_videos
ChatGPTList videos in the selected TikTok catalog with SKU links, processing status and six-hour previews. Read-only. If permitted, the gallery links to the separately listed tiktok_delete_catalog_video tool for preview and approval.
tiktok_create_ad_group
ChatGPTCreate an advertiser-owned ad group with explicit objective-dependent settings. Budgets/bids are whole currency units; schedules use advertiser time. Policy may force DISABLE. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_create_ads
ChatGPTCreate up to 20 standard or Spark ads in an account-owned ad group. Use existing authorized identity and media IDs. Policy may force every creative to DISABLE. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_create_campaign
ChatGPTCreate a TikTok campaign. Budget is a float in whole account-currency units (min ~20 USD-equivalent for DAY/TOTAL modes). TikTok has no server-side dry run — the preview is a client-side diff. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
tiktok_create_catalog
ChatGPTCreate an empty catalog using creation-delegation/region hashes and explicit immutable configuration. Independently verifies the native ID/configuration, then adopts only that new ID for project read/write access under owner delegation. No ads, products or spend; no automatic replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_create_catalog_feed
ChatGPTCreate a feed in an authorized TikTok catalog. An optional public HTTPS source and schedule can start processing. OVERWRITE can remove products. Requires acknowledgment of processing and effects on existing products and ads. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_create_customer_audience
ChatGPTCreate an audience from1–49 distinct approved upload receipts of one encryption type. Enhancement is disabled. Verifies owned ID/name/type metadata, returns processing pending, and claims no individual membership or delivery change. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_create_lookalike_audience
ChatGPTCreate a lookalike from an available non-lookalike seed with at least 100 native matched users and fresh source snapshot_hash. Uses modern native fields, explicit seed inclusion/OS/placements/locations/breadth and processing-pending metadata readback. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_create_pixel
ChatGPTCreate a native advertiser Pixel record and independently verify the returned ID and fields. Does not install tracking, send events or change ads. TikTok controls creation defaults; no automatic retry. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_create_product_set
ChatGPTCreate a filter-defined set in a writable catalog using its configuration_hash. Native and/or operators, up to 1,024 combined values; no ad activation. Independently verifies the created set; never automatically replays an uncertain create. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_create_rule_audience
ChatGPTCreate a rule audience with fresh source context_hash and explicit automatic refresh. Rechecks all source access, disables enhancement and independently verifies owned ID/name metadata. Native event names/rule representation remain authoritative; returns processing pending. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_create_saved_audience
ChatGPTCreate a reusable targeting template with native location, interest, audience, device and action fields. No campaign, budget or delivery update. Requires the existing advertiser permission; independently verifies creation and never retries automatically. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_custom_audience_shares
ChatGPTRead owned audience sharing logs for explicit destination accounts. Hosted scope requires source and destinations enabled in this project. Other recipient names/IDs stay hidden. Native status is preserved; missing list data does not prove absence.
tiktok_custom_audiences
ChatGPTPage custom audiences, matched coverage and native availability. Supports up to100 exact ID filters. Explicit native pagination distinguishes missing completeness from absence; saved targeting templates are separate.
tiktok_delete_catalog
ChatGPTPermanently delete one writable catalog with fresh configuration_hash, exact name confirmation and contents/shared-effects acknowledgement. Deletes current products/feeds; contents are not enumerated/frozen. Verifies native receipt and filtered absence; errors are not absence. No restore or replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_delete_catalog_feed
ChatGPTPermanently delete one verified shared feed using its configuration_hash. Exact native receipt and complete catalog feed absence check required. Dependent products/ads must be reviewed; uncertain results are never replayed. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_delete_catalog_products
ChatGPTRemove verified native product IDs using products_hash and fresh catalog/feed hashes. Maps native external IDs to documented deletion selectors; Entertainment removal is undocumented and refused. Requires removal/shared/async acknowledgements. Returns accepted task; never replays. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_delete_catalog_video
ChatGPTRemove one composite catalog-video ID with its fresh configuration_hash and shared-effects acknowledgement. Rechecks native state, issues one delete and verifies filtered-view absence. Existing catalog ads may be affected; synced advertiser-library copies remain separate. No automatic replay or restore. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_delete_custom_audiences
ChatGPTPermanently delete1–100 owned audiences with exact names/hashes and explicit acknowledgements. Shared-recipient access is not ownership. Requires complete filtered absence readback; no restore, usage freeze or automatic replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_delete_product_sets
ChatGPTPermanently delete 1–10 verified shared product sets with a fresh hash for each. Preview lists every name/ID; exact native receipt and independent catalog readback required. No automatic replay after uncertain/partial outcomes. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_delete_saved_audiences
ChatGPTPermanently delete up to100 saved targeting templates using each current snapshot_hash. All IDs must match before any write; filtered readback confirms deletion. No restore endpoint or automatic retry. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_get_automated_rules
ChatGPTInspect explicit advertiser rule IDs, preserving configuration, native IDs and execution summaries. Unreturned IDs are not proof of absence; Adport limit100 IDs/request.
tiktok_get_catalog
ChatGPTRead one explicitly granted Business Center catalog, native eligibility and configuration_hash. Verifies exact catalog and Business Center IDs; does not enumerate unrelated catalogs.
tiktok_get_custom_audience
ChatGPTRead exact audience ownership, configuration, availability, expiry and snapshot_hash. Missing native status remains unavailable. Customer identifiers and raw provider error/history messages are excluded.
tiktok_get_pixel
ChatGPTRead one advertiser Pixel and its configuration_hash using the ID-filtered native list endpoint. Matching settings are returned for review; tracking is not installed.
tiktok_get_saved_audience
ChatGPTRead one saved targeting template using TikTok’s ID-filtered list endpoint; verifies the selected advertiser and ID and returns its current snapshot_hash.
tiktok_identities
ChatGPTPage identities already linked to the advertiser. Preserves native identity/BC references and availability; BC queries may include other linked identities. Creates no identity or permissions. Exact video source use rechecks identity/info.
tiktok_image_info
ChatGPTRead advertiser image IDs, dimensions and returned preview URLs.
tiktok_import_catalog_file
ChatGPTSubmit a checksum-bound project CSV as a one-time catalog feed import. Fresh catalog/feed hashes, explicit mode and asynchronous/shared-effects acknowledgement; OVERWRITE also requires deletion acknowledgement. Returns an accepted native job, not completed ingestion. Never automatically replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_pixel_event_stats
ChatGPTRead native event statistics for explicit Pixel IDs and a date range. Adport limit 20 IDs/request. Returns provider-native fields; does not send test or live conversion events.
tiktok_pixels
ChatGPTRead/filter advertiser Pixels by native ID, code, name, order or catalog availability; max 20/page. Returns configuration_hash and explicit pagination certainty; no tracking events or configuration changes.
tiktok_product_set_products
ChatGPTRead products in one verified product set within a granted catalog. Native page navigation, safe string IDs and explicit pagination certainty. Adport limits each page to 100 products.
tiktok_product_sets
ChatGPTBrowse one granted catalog’s product sets or an exact set, with configuration hashes. Snapshot-bound local paging; native endpoint returns all sets, bounded to 5,000. Product counts default off to avoid native timeouts.
tiktok_refresh_lookalike_audiences
ChatGPTRefresh 1–100 owned available lookalikes using each current snapshot_hash and shared-effects acknowledgement. Rechecks all targets before one native batch and preserves known metadata. Processing/membership is not confirmed; no automatic retry. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_rename_custom_audience
ChatGPTRename an owned available non-expiring custom audience with current snapshot_hash. Independently checks preserved known configuration; sends no file paths or subtype conversion. Native expiry may reset. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_rename_product_set
ChatGPTRename one verified product set using its configuration_hash and shared-effects acknowledgement. Preserves filter conditions, independently reads back the set and never automatically replays an uncertain write. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_report
ChatGPTRaw TikTok synchronous reporting (report/integrated). Metric values come back as strings; note total_complete_payment_rate is total purchase VALUE (misleading name), complete_payment_roas is purchase ROAS.
tiktok_rule_audience_context
ChatGPTValidate exact inclusion/exclusion rules, nested URL/web-parameter filters and each source or explicit all-advertiser scope. Returns context_hash for creation. Does not freeze events, future sources or matched users.
tiktok_saved_audiences
ChatGPTList or filter saved targeting templates, up to100 IDs and100 rows/page. Returns snapshot_hash for deletion and explicit native completeness; does not upload customer data or send tracking events.
tiktok_search_targeting
ChatGPTSearch location/zip targeting tags using TikTok’s read-only POST endpoint. Targeting eligibility depends on objective, placement and promotion type.
tiktok_set_ad_group_bidding
ChatGPTEdit supplied ad-group bids and target ROAS. Monetary bids use whole account-currency units and current-value policy checks. Serving status remains unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_set_ad_group_budget
ChatGPTChange a verified ad-group budget in whole account-currency units. Current/proposed amounts are policy-checked; TikTok also enforces spend-based minimums. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_set_ad_group_status
ChatGPTEnable or pause verified advertiser-owned child entities. Parent serving settings remain independent. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_set_ad_status
ChatGPTEnable or pause verified advertiser-owned child entities. Parent serving settings remain independent. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_set_budget
ChatGPTChange a TikTok campaign's budget (whole currency units). TikTok rejects new budgets below 105% of current spend. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
tiktok_set_campaign_status
ChatGPTEnable or pause (DISABLE) up to 20 TikTok campaigns. Two-step write: call WITHOUT pending_operation_id to get a dry-run preview and a pending_operation_id; call again with IDENTICAL arguments plus that id to apply.
tiktok_set_catalog_feed_schedule_status
ChatGPTSwitch a verified feed ON/OFF with a fresh configuration_hash. ON can resume automatic product changes; requires an existing source, interval and timezone. Opposite state only; independent preservation readback and no replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_share_custom_audiences
ChatGPTShare1–10 eligible owned audiences with1–10 selected accounts in the same Business Center after current context and recipient-access acknowledgement. All affected accounts obey project/protected-account policy. Independent pair readback; accepted sharing does not certify audience availability or delivery. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_unbind_catalog_event_sources
ChatGPTUnbind explicit selected advertiser app/Pixel sources using fresh context hashes. Requires existing membership and shared/measurement-effects acknowledgement. Verifies absence and preservation of unselected binding identities. No unbind-all inference or replay; no events sent. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_unshare_custom_audience
ChatGPTRevoke sharing for one exact audience/recipient pair after context and shared-effects acknowledgement. Can affect destination ad targeting. Preserves the source audience; verifies explicit log absence. Does not delete customer data or pause ads. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_update_ad
ChatGPTPatch supplied ad text/name, landing page or media IDs in its verified ad group. Uses patch_update=true; serving status and omitted creative fields are preserved. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_update_catalog
ChatGPTRename an explicitly writable catalog using a fresh configuration_hash and shared-effects acknowledgement. Native JSON POST plus independent readback; no ads activated and no automatic retry. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_update_catalog_feed
ChatGPTUpdate a selected TikTok feed using its current configuration hash. A replacement source must be a public HTTPS URL. OVERWRITE can remove products. Requires acknowledgment of processing and effects on existing products and ads. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_update_catalog_products
ChatGPTPatch product fields selected by verified native product IDs and products_hash. External identities are derived from native context and cannot be edited. Fresh catalog/feed hashes required; asynchronous task and shared-effects acknowledgements. Read the schema first; no automatic replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_update_customer_audience_users
ChatGPTAPPEND, REMOVE or REPLACE an owned available Customer File Audience using current snapshot_hash and matching upload receipts. Requires explicit shared-effects acknowledgement. Native membership processing/size/quota remain authoritative; accepted is not processed. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_update_pixel
ChatGPTUpdate Pixel name or explicit email/phone matching flags using its current configuration_hash. Verifies current settings before writing and independently reads back the result. Omitted flags are preserved; no tracking install or event sending. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_update_product_set_conditions
ChatGPTReplace one set’s entire product filter definition using its configuration_hash. Existing ads may select different products. Preserves name, requires shared-effects acknowledgement and independently verifies the result. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_update_targeting
ChatGPTReplace only supplied ad-group targeting dimensions. Omitted targeting and serving settings remain unchanged; supplied arrays replace existing lists. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_upload_audience_file
ChatGPTUpload a checksum-bound private CSV/TXT of hashed identifiers from project media or local CLI. Validates the declared hash format and native multipart MD5. Returns a credential/advertiser-bound24-hour receipt; creates no audience and never retries uncertain uploads. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_upload_catalog_videos
ChatGPTSubmit a checksum-bound library CSV to the native catalog-video file API, using fresh import-context hashes. May feed existing catalog ads; explicit delivery/shared/async acknowledgement required. Optional sync targets only the selected advertiser and requires copy acknowledgement. Returns an accepted job, not ingestion/sync success; no replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_upload_image
ChatGPTUpload advertiser image bytes with SHA-256-bound approval and TikTok MD5 signature. Hosted calls require media_id; file_path is local-only. Adport limits: images10MiB, videos100MiB. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_upload_product_set
ChatGPTCreate an ECOM product set from a checksum-bound CSV in project media (or local file_path). Official sku_id header, 1–5,000 distinct rows, unique name up to28 chars and fresh catalog hash. Native multipart/MD5; verifies created ID/name, not full membership. Never replay an uncertain create. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_upload_video
ChatGPTUpload advertiser video bytes with SHA-256-bound approval and TikTok MD5 signature. Hosted calls require media_id; file_path is local-only. Adport limits: images10MiB, videos100MiB. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_upsert_catalog_products
ChatGPTUpload up to5,000 native JSON products using the catalog-type schema. Can replace existing external identities; fresh catalog/feed hashes and explicit replacement/shared/async acknowledgements required. Returns an accepted task, not completed ingestion. No automatic replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
tiktok_video_info
ChatGPTRead advertiser video IDs, processing metadata and returned playback/cover URLs.
tiktok_videos
ChatGPTSearch the advertiser video library with native filtering and pagination.
x_account_media
ChatGPTView native Account Media assets with cursor paging and safe image/video previews. These IDs are distinct from media-library keys and serving associations. Unknown or VAST formats retain native metadata without invented previews.
x_account_media_usage
ChatGPTInspect one Account Media source and complete bounded usage, including deleted-parent references. Reference details are paged; later offsets require the original context hash. Returns deletion eligibility; used sources need separately reviewed disassociation first.
x_add_targeting_criterion
ChatGPTAdd one native criterion without replacing other dimensions. Referenced audiences/campaigns/users/apps are verified. Can change an active group’s audience immediately. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_app_event_tags
ChatGPTInspect native app event tags, app identity, conversion type and attribution windows with exact ID filters and cursor pagination. Sends no app events.
x_authenticated_user_access
ChatGPTRead the authenticated actor and native account permissions, including TWEET_COMPOSER when granted.
x_cards
ChatGPTBrowse native website/app/carousel cards with bounded media previews, copy edits and cursor pagination. Cards are separate from post publication and ad delivery. Legacy inclusion is explicit; this inventory does not replace exact-URI cards/all lookup.
x_conversion_stats
ChatGPTRead native WEB_CONVERSION or separately requested MOBILE_CONVERSION objects for up to 20 verified entities and 30 account-local dates. Placement is explicit. Preserves native fields/units; does not label them normalized conversions, revenue, CPA or ROAS.
x_create_campaign
ChatGPTCreate a paused X Ads campaign with an existing funding instrument and account-currency budgets in integer micros. Preview is local. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_create_card
ChatGPTCreate an unattached website/app or carousel card from ready account-owned image/video media. Uses the native JSON body and independently verifies content. Does not publish posts or create ad associations. Local preview only; never repeat an unconfirmed creation. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_create_custom_audience
ChatGPTCreate an empty owned CRM audience placeholder. Independently reads back ownership and approved metadata; no user upload, ad association, sharing or activation. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_create_line_item
ChatGPTCreate a paused X ad group with explicit objective, product, placements and flight. Budgets/bids use micros; AUTO cannot claim a monetary bid cap. Parent currency and sibling format are checked. Optional native goal and primary conversion tag require a fresh tag hash; native eligibility remains authoritative. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_create_media_creative
ChatGPTAssociate one verified Account Media asset with a MEDIA ad group using context_hash and explicit native ACTIVE acknowledgement. paused_creation requires a PAUSED ad group. WEBSITE_CLICKS needs landing_url; preroll destinations use separate native CTA settings. Checks receipt/readback; no upload, parent edit or replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_create_preroll_cta
ChatGPTSet one native preroll CTA with context_hash and explicit ad-group scope acknowledgement. Refuses existing active CTAs; paused_creation requires a PAUSED ad group. Five native button presets; exact URL/receipt/readback checks. No ad creation, activation or replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_create_promoted_account
ChatGPTAssociate one verified FULL promotable profile using expected_context_hash and explicit ACTIVE/live-profile acknowledgements. paused_creation requires a PAUSED ad group. Rejects duplicates, checks receipt and readback, and never retries an uncertain write. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_create_promoted_only_post
ChatGPTCreate a distinct PUBLISHED promoted-only post with nullcast=true, expected_context_hash and confirm_publication. Does not publish organically, consume a draft or associate an ad. Native text/attachment rendering is qualified by independent readback; no replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_create_promoted_posts
ChatGPTAssociate1–50 verified published FULL-author posts with one ad group. Requires context_hash and acknowledging native ACTIVE associations. paused_creation requires a currently PAUSED ad group. Existing posts/parents/budgets stay; no fictitious PUT pause. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_create_repost_promotions
ChatGPTPromote one to 50 authorized RETWEETS_ONLY source posts as new published nullcast copies and ACTIVE associations. Requires context_hash and both acknowledgements. Uses one source per native request, at most four concurrent; paused_creation requires a PAUSED ad group. Returns explicit source/copy/association mappings. Partial outcomes stop new writes, retain known IDs and are never replayed. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_create_scheduled_post
ChatGPTSchedule a new promoted-only post with expected_context_hash and automatic-publication acknowledgement. Forces nullcast=true; no draft consumption or ad association. Independent native receipt/readback; uncertain writes are never replayed. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_create_scheduled_promoted_post
ChatGPTAssociate one still-future schedule with an ad group after context_hash and automatic-promotion acknowledgement. paused_creation requires a currently PAUSED ad group; native has no association status or PUT pause. Existing money pools remain policy-checked. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_create_tracking_tag
ChatGPTAssociate an HTTPS impression or click tracker with an existing non-draft line item. May immediately change measurement on an active ad group. Verifies native receipt/readback; sends no test event and never retries automatically. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_custom_audience_permissions
ChatGPTInspect existing audience sharing permissions with native cursor/ID filters; does not grant, revoke or expand access.
x_custom_audience_usage
ChatGPTInspect all targeted campaigns, including inactive groups, sharing permissions and direct audience inclusion/exclusion criteria. Bounded complete scan supplies usage_hash for deletion; incomplete scans fail.
x_custom_audiences
ChatGPTList owned or already shared X custom audiences with exact native cursor filters, targetability and configuration hashes. Load more retains selection; no members are returned.
x_delete_account_media
ChatGPTDelete one unused native Account Media source with expected_context_hash and explicit source-deletion acknowledgement. Requires a complete usage scan with no non-deleted ad associations; checks DELETE receipt and independent source/usage readback. No automatic detach, library deletion or retry. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_delete_card
ChatGPTDelete one modern card after a matching snapshot and shared-effects acknowledgement. Existing uses may be affected; no restore endpoint is established. Verifies exact native deletion/readback; does not pause an ad or campaign. No automatic retry. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_delete_custom_audience
ChatGPTDelete an owned unreferenced, unshared audience using current configuration and usage hashes. Checks inactive targeting and exclusions, then independently verifies deleted=true. No restore endpoint is claimed. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_delete_line_item
ChatGPTDelete a verified line item only after its promoted posts/accounts/media creatives are removed. Native receipt must confirm deletion. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_delete_media_creative
ChatGPTDisassociate one exact direct-media ad with expected_context_hash, native DELETE and independent tombstone readback. Preserves Account Media, library assets, other associations and parent status/budgets. No fictitious PUT pause or automatic replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_delete_media_library_item
ChatGPTDelete a verified native media-library record. Existing posts/ads may retain media; this is not an ad pause or proof of underlying byte deletion. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_delete_preroll_cta
ChatGPTRemove one exact preroll CTA with expected_context_hash and ad-group scope acknowledgement. Checks native tombstone and remaining CTA inventory; retains media, ads and parent delivery/budgets. Removing a CTA does not pause ads; no automatic replay. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_delete_promoted_account
ChatGPTDisassociate one exact profile ad with expected_context_hash, native DELETE and independent tombstone readback. Preserves the X profile, other ads, parent delivery and budgets. No profile deletion or fictitious PUT status edit. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_delete_promoted_post
ChatGPTDisassociate one exact promoted-post association with expected_context_hash, native DELETE and independent tombstone readback. Retains published post/media/other associations. This is the native ad-level removal/pause workflow; re-promotion needs a new preview. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_delete_scheduled_post
ChatGPTPermanently cancel/delete a still-future promoted-only schedule after snapshot and deletion acknowledgement. Requires no live scheduled ad associations. Native DELETED receipt plus independent HTTP404; published posts are separate. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_delete_scheduled_promoted_post
ChatGPTRemove one exact scheduled ad association before its publication time, with expected_context_hash and independent tombstone readback. Keeps the scheduled post; after publication inspect/remove the ordinary promoted-post association instead. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_delete_tracking_tag
ChatGPTDisassociate a tracking tag using a current configuration_hash. Verifies native deleted=true and independent readback. Can stop third-party measurement; does not pause ads or claim a restore endpoint. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_get_account_media
ChatGPTRead one exact account-owned Account Media asset and configuration hash. Does not turn a media-library key or upload receipt into an Account Media ID.
x_get_app_event_tag
ChatGPTRead one native app event tag and attribution windows in the selected account. Sends no events.
x_get_campaign
ChatGPTRead one campaign’s native budget, funding, currency and delivery configuration within the selected account.
x_get_card
ChatGPTRead one modern card by numeric ID within the selected account, including full native configuration and configuration_hash for edits/deletion.
x_get_cards
ChatGPTRead exact native cards by account-associated card URI, including legacy card content.
x_get_custom_audience
ChatGPTRead one selected-account custom audience, ownership and configuration_hash. Processing/size/targetability are native diagnostics, not proof of exact member contents.
x_get_line_item
ChatGPTRead native line-item bid, budgets, schedule and other configuration, verifying its ID and account-scoped campaign/currency.
x_get_media_creative
ChatGPTRead an exact direct-media association, parent configuration and context_hash. Media-creative IDs are distinct from their source account_media_id. Deleted tombstones may retain ACTIVE.
x_get_media_library_item
ChatGPTRead one account-scoped media-library item, including native processing readiness and preview URLs.
x_get_preroll_cta
ChatGPTRead an exact account-owned preroll CTA, parent and complete active CTA inventory, with context_hash and guarded widget edits. CTA scope is the ad group, not one media association.
x_get_promoted_account
ChatGPTRead one exact promoted-account association, including deleted tombstones, verified parents and context_hash. Profile content is live and is not snapshotted by this Ads endpoint.
x_get_promoted_post
ChatGPTRead an exact account-owned promoted-post association, its parent settings and context_hash. ID is the association ID, not the published tweet_id. Tombstone can retain native ACTIVE status.
x_get_published_post
ChatGPTRead an exact published post for this account and current promotable author, including snapshot_hash. Never treats a missing response as global absence or substitutes rounded numeric IDs.
x_get_scheduled_post
ChatGPTRead an exact author/account-owned scheduled post, matching current ad associations and snapshot_hash. Scheduled ID and eventual published tweet_id are distinct. Complete association inventory is required for edit/delete context.
x_get_scheduled_promoted_post
ChatGPTRead an exact scheduled ad association, source schedule, parent configuration and context_hash. Uses the association ID, distinct from scheduled_tweet_id and eventual published tweet_id.
x_get_targeting_criterion
ChatGPTRead one criterion and verify its line-item/campaign account hierarchy.
x_get_tracking_tag
ChatGPTRead one impression/click tracking tag and its configuration_hash after checking its line item and campaign in the selected account.
x_get_web_event_tag
ChatGPTRead one website conversion tag by exact account and ID, without executing embed code or sending an event.
x_line_item_placements
ChatGPTRead current native placement combinations by product type after verifying access to the selected account.
x_list_campaigns
ChatGPTList X Ads campaigns including inactive, deleted and draft campaigns.
x_list_funding_instruments
ChatGPTList existing funding instruments for campaign creation; does not create or change billing.
x_list_line_items
ChatGPTList X Ads line items (ad groups).
x_media_creative_context
ChatGPTReview an existing Account Media asset, MEDIA ad group and complete bounded association inventory before linking. Binds source, parent, destination and existing associations in context_hash. Supports PREROLL and documented TAP image formats; VAST authoring is unverified.
x_media_creatives
ChatGPTView direct-media ad associations in one verified ad group, with native paging, source previews and guarded disassociation actions. Native ACTIVE association state is separate from parent delivery.
x_media_library
ChatGPTView native account media-library images, GIFs and videos, processing state and metadata edit actions.
x_media_upload_status
ChatGPTRead native upload processing only with the signed receipt from this account’s approved upload. Native IDs alone do not authorize account-less status reads.
x_post_creation_context
ChatGPTCheck exact promoted-only post fields, FULL/composer authority and ready account-owned media/cards. Returns context_hash for publication. Creates nothing; existing drafts stay separate.
x_preroll_cta_context
ChatGPTReview a new preroll button/destination and complete current ad-group CTA inventory before creation. Returns context_hash; requires an existing non-draft PREROLL_VIEWS ad group. Existing CTA settings need explicit update, not an implicit POST replacement.
x_preroll_ctas
ChatGPTBrowse native preroll CTA buttons/destinations with cursor paging. Account-wide browsing avoids parent fan-out; inspect an exact CTA for editing. Optional line_item_id enables scoped edit/removal actions bound to full inventory and parent settings. Incomplete edit context stays read-only.
x_promotable_users
ChatGPTRead account-associated users and FULL/RETWEETS_ONLY eligibility for creative authoring.
x_promoted_account_context
ChatGPTReview a current FULL promotable user, FOLLOWERS ad group and complete bounded association inventory before linking. Binds identity, parent configuration and existing associations to context_hash; no publication or profile edit.
x_promoted_accounts
ChatGPTView profile-ad associations in one verified PROMOTED_ACCOUNT ad group, with cursor paging, profile links and guarded removal. Native ACTIVE is association state; parent delivery remains separate.
x_promoted_posts
ChatGPTView one verified ad group’s promoted-post associations with native cursor paging and guarded disassociation. Optional user_id hydrates published content for that associated author. ACTIVE is association state, not proof of delivery.
x_promotion_context
ChatGPTRead complete current source/parent context for associating1–50 existing FULL-author posts to one ad group. Hash binds posts, parent delivery/money and matching existing associations. Does not promote; RETWEETS_ONLY copying is separate.
x_published_posts
ChatGPTView published promoted-only/organic posts for an explicit account-associated author, with native media/copy and guarded name edits. PUBLISHED is not ad delivery. Native cursors support Load more; text edits use a new post.
x_register_uploaded_media
ChatGPTRegister an approved, processed upload in its account’s native media library. Requires its unexpired signed receipt, checks current author/processing, and preserves upload IDs on a partial failure. No post publication or ad association. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_remove_targeting_criterion
ChatGPTRemove one verified native criterion. Preview identifies removal of the last location bound. Multi-step replacements should be reviewed with the group paused. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_rename_published_post
ChatGPTRename an owned published post with expected_snapshot_hash. Uses native PUT tweets/id/name; published copy/media/status and associations are preserved and independently read back. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_repost_promotion_context
ChatGPTReview one to 50 published posts from a current RETWEETS_ONLY author for native copy promotion. Verifies unique FULL receiving author, complete source/parent/association inventory and context_hash. New nullcast copies get different IDs; existing reposts cannot be reliably deduplicated by source ID.
x_scheduled_post_context
ChatGPTCheck FULL/composer authority, owned ready attachments and a UTC-minute schedule,15minutes to one calendar year ahead. Returns context_hash without creating content. Only promoted-only nullcast publication is supported.
x_scheduled_posts
ChatGPTView one account-associated author’s scheduled posts, copy, native state and bounded media previews. Native cursors support Load more; SCHEDULED is automatic future publication, not a paused ad.
x_scheduled_promoted_posts
ChatGPTList one account-owned ad group’s scheduled-post associations with native cursors. These have no native status/PUT pause; tweet_id appears after publication. Does not infer delivery from association existence.
x_scheduled_promotion_context
ChatGPTCheck exact future FULL-author schedule, complete matching association inventory and parent delivery/budget context. Returns context_hash for automatic promotion; creates nothing.
x_set_budget
ChatGPTChange an existing X Ads daily or total campaign budget in integer micros, preserving the other cap. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_set_campaign_status
ChatGPTPause or activate an existing X Ads campaign. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_set_line_item_bidding
ChatGPTChange native AUTO/MAX/TARGET bidding with current monetary values. Removing a bounded bid via AUTO is rejected because policy cannot represent an unbounded change. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_set_line_item_budget
ChatGPTChange an existing line-item daily or total cap in integer micros, preserving the other cap and using current values for policy checks. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_set_line_item_status
ChatGPTPause or activate a verified line item using native PUT. Draft/deleted line items are rejected. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_targeting_criteria
ChatGPTRead native criteria for selected verified line items, including type/value/operator and native cursor pagination.
x_targeting_options
ChatGPTRead current native targeting choices. Filters are checked per dimension. Unpaged dimensions use count as a local limit and report potential truncation.
x_tracking_tags
ChatGPTInspect native impression/click tracking tags with account/line-item ownership checks, configuration hashes and native cursor/ID filters.
x_update_card
ChatGPTEdit one modern card using its current configuration hash. Omitted fields stay unchanged; components/slides replace their layout. Copy shortcuts edit a supported current layout and require slide_index for multi-destination cards. Shared changes can affect existing posts/ads immediately; acknowledgement required. No automatic retry. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_update_custom_audience
ChatGPTEdit an owned audience name or description using a fresh configuration_hash. Preserves omitted metadata and audience type; independently verifies native readback. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_update_custom_audience_users
ChatGPTSubmit explicit Update/Delete member groups to an owned CRM audience. Identifiers must already be normalized SHA256, except native partner_user_id. Preview shows counts/digest; receipt confirms processing acceptance, not targeting readiness. No automatic retry. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_update_line_item
ChatGPTEdit supplied line-item name/start/end fields, preserving omitted schedule bounds and delivery status. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_update_media_library
ChatGPTEdit native media-library metadata or a video poster, preserving omitted fields. Metadata can be shared with existing creatives; library status is separate from ad delivery. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_update_preroll_cta
ChatGPTEdit supplied native CTA button/destination fields with expected_context_hash and ad-group scope acknowledgement. Sends only actual changes, preserves omitted fields and parent settings, and verifies the receipt plus independent readback. Affects the ad group’s preroll ads. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_update_scheduled_post
ChatGPTEdit a still-future, promoted-only SCHEDULED post with expected_snapshot_hash. Omitted fields remain; media_keys:[] and card_uri:null clear attachments. Existing associations require shared-effects acknowledgement. No organic-state change. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_update_targeting
ChatGPTAtomically add/remove 1–500 criteria on one verified line item through native JSON batch. Checks final targeting dependencies, source availability and each ordered receipt; other dimensions remain unchanged. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_update_tracking_tag
ChatGPTChange only a tracking-tag URL using a current configuration_hash. Preserves its parent/type and independently reads back the result. May affect active measurement immediately; no automatic retry. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_upload_media
ChatGPTUpload SHA-256-bound image/GIF/video bytes through native v2 initialize/append/finalize with the existing OAuth1 grant. Returns a signed account/author-bound processing receipt; does not register, publish or attach an ad. Omit pending_operation_id to preview. To apply, repeat IDENTICAL arguments with the returned ID.
x_web_event_tags
ChatGPTInspect native account-scoped website conversion tags and embed code as inert data. Native cursors preserve pagination. This does not create events or install a pixel.