approve_google_rule_action
ChatGPTApprove/reject a pending rule action. Execution rechecks evidence, entitlement, limits and emergency stop.
complete_asset_upload
ChatGPTAfter the file was PUT to the uploadUrl from create_asset_upload, upload it to the platform asset library, store it in AdLiftr and delete the temporary copy. Returns the asset; pass its id as assetId in create_campaign. Google video uploads can publish an unlisted YouTube video.
create_asset_upload
ChatGPTStart uploading a local image or video file. Returns either an existing identical asset (mode "existing") or a one-hour uploadUrl: PUT the raw file bytes to it with the returned uploadHeaders, then call complete_asset_upload with the same uploadId. Files go to a temporary bucket that deletes them within one day.
create_automated_rule
ChatGPTCreate a native Meta or TikTok automated rule that the platform runs on its own (Meta hourly, TikTok every 30 minutes). Templates: pause_spend_no_results (e.g. pause ads that spent $50 with no results), scale_budget_winner (raise campaign or ad-set budgets by a percentage once a day when results are good), notify_bad_cost. entity_level can be campaign, ad_set or ad. Leave out targets to watch every active item at that level, or pass targets to watch only chosen campaigns, ad sets or ads (or what sits inside them). Use list_ad_accounts for ad_account_id and list_campaigns, list_ad_sets, list_ads or search_entities for target UUIDs. The rule can pause delivery or raise spend without further confirmation.
create_campaign
ChatGPTCreate a campaign with a batch of creatives in adSets[].ads. Use assetId to reuse an existing account-owned asset, or mediaUrl plus fileName to import new media. Supports Meta, TikTok, Google Ads and Snapchat. Use one call per platform and advertising account to reuse creatives across platforms. Gather budget, targeting, identities and compatible media before launch. Set launch.startPaused=true only for tests or when the user requests a paused campaign. Active campaigns can publish ads and incur platform spend that cannot be refunded by pausing; retries can create duplicate campaigns.
find_ads
ChatGPTFind ads across every enabled ad account in a workspace by performance, in one call. Losers: minSpend=50, maxResults=0 (an ad with spend and no reported results counts as 0 results). Winners: maxCostPerResult=30, minResults=1, sort=cost_per_result, order=asc. Filters: platform, platformAdAccountId, campaignIds, status (active by default). Scans up to 2,000 ads (truncated=true when more exist); null metrics are unavailable. Pass the returned IDs to set_status to pause or activate them. The entitlement check can update local billing state. Does not change provider delivery.
get_creative_issue
ChatGPTFetch the full issue breakdown for one grouped creative issue row.
get_dashboard
ChatGPTFetch a workspace dashboard overview from authorized accounts. The entitlement check can update local billing state and disable local ad-account access when a trial expires or a plan limit is exceeded. Does not change provider campaign delivery.
get_ecommerce_performance
ChatGPTRead stored Google purchase performance. Check coverage/missingDates and currency before interpreting ROAS/CPA. Product metrics describe advertised products.
get_ecommerce_sync_status
ChatGPTRead reporting job checkpoints, completion and errors after queuing sync or backfill.
get_google_operations
ChatGPTInspect durable Google campaign operations. A reconciling state is an unknown outcome; never submit a new launch key to retry it.
get_google_retail_configuration
ChatGPTRead current retail campaign settings and group IDs before changing product selections.
get_performance
ChatGPTFetch performance metrics for campaigns, ad sets, or ads in authorized accounts. The entitlement check can update local billing state and disable local ad-account access when a trial expires or a plan limit is exceeded. Does not change provider campaign delivery.
get_template
ChatGPTGet one saved template: its summary and the full saved setup, including each ad set's ads, copy, landing pages, UTMs and Post IDs.
import_asset_from_url
ChatGPTFetch a supplied image or video URL, upload it to the authorized platform asset library, and persist its local metadata, potentially overwriting an existing asset record. Google video imports can publish an unlisted YouTube video. Retries may repeat uploads after a partial failure.
import_chat_files
ChatGPTImport images and videos the user attached in this conversation into an ad account's media library, so they can launch as ads. Returns one assetId per file; pass them as adSets[].ads[].assetId (with mediaType) to create_campaign. Up to 50 files per call. Outside ChatGPT, pass any public download_url in the same shape.
launch_template
ChatGPTLaunch a saved builder template: its ad account, page, pixel, event, ad sets, budgets, copy, UTMs, naming, Advantage+ settings and extra pages/ad accounts. Pass ads (assetId from list_assets or import_chat_files, or mediaUrl plus fileName) to launch new creatives with the template's copy, UTMs and Post IDs by position; leave ads out to launch the template's own saved ads. Launches live unless startPaused=true; active ads can spend immediately and retries can create duplicate campaigns.
list_ad_accounts
ChatGPTList connected ad accounts across platforms.
list_ad_profiles
ChatGPTList connected Facebook, Instagram, TikTok, and Snapchat profiles.
list_ad_sets
ChatGPTList ad sets/ad groups in a workspace.
list_ads
ChatGPTList ads in a workspace.
list_asset_group_assets
ChatGPTList Performance Max creative links with returned text, image/video, CTA, supported extension and policy details. Inspect details_availability for identity-only asset types. Filter by campaignIds or assetGroupIds. scope=all includes campaign-level brand assets for the selected groups' campaigns. Each row is a link, so one asset can have multiple roles. Paginate all results; inspect coverage/warnings. These are not standalone ads and cannot be passed to update_ad or update_ad_set.
list_asset_groups
ChatGPTList Google Performance Max asset groups. Use campaignIds from list_campaigns. Inspect coverage/warnings and paginate all results. These are read-only asset_group entities, not conventional ad groups. Use get_performance with entityLevel=asset_group and returned local UUIDs.
list_assets
ChatGPTList image/video assets in a workspace.
list_automated_rules
ChatGPTList AdLiftr-managed automated rules in a workspace.
list_campaigns
ChatGPTList campaigns in a workspace with pagination and search.
list_connections
ChatGPTList Meta, TikTok, Google, and Snapchat platform connections.
list_creative_issues
ChatGPTList grouped creative issues in a workspace. Returns one row per affected creative/entity and filters to active campaigns by default.
list_google_rules
ChatGPTList Google automation rules, evidence, execution history and emergency-stop state.
list_merchant_centers
ChatGPTList Merchant Center accounts linked to the selected Google Ads account.
list_pixels
ChatGPTList platform pixels or Google conversion actions.
list_shopping_products
ChatGPTRead products and eligibility/issues for the builder or campaign. Paginate nextPageToken; preserve exact item IDs, language, channel and feed label.
list_templates
ChatGPTList the campaign templates saved in the AdLiftr builder for a workspace, each with a summary: platform, objective, ad account, page, pixel, event, ad sets, budgets, naming patterns, Advantage+ setting, extra destinations and saved Post IDs. Use launch_template to launch one.
list_workspaces
ChatGPTList AdLiftr workspaces available to the authenticated user.
manage_google_retail_campaign
ChatGPTValidate or manage Shopping/retail PMax budgets, status, bidding, product exclusions, targeting, asset groups, creative links and negatives. Requires idempotency key. Activation is explicit.
reconcile_google_operation
ChatGPTRe-read provider results for an uncertain operation without repeating resource creation.
save_google_rule
ChatGPTConfigure a Google rule with minimum data, conversion lag, cooldown and action/budget limits. Approval mode is the default.
search_entities
ChatGPTSearch campaigns, ad sets, ads, assets, pixels, ad accounts, and rules. Use this before mutating when IDs are unknown.
set_google_automation_stop
ChatGPTEnable or disable the account's Google automation emergency stop. Enabled by default.
set_status
ChatGPTSwitch many campaigns, ad sets or ads on or off in one call (up to 500 IDs from list_* or find_ads). For campaigns, includeChildren=true also switches every ad set and ad inside them, e.g. to turn on a campaign launched paused. Returns updated IDs and per-ID failures. Activation can deliver public ads and incur platform spend; pausing interrupts delivery.
sync_connection
ChatGPTSync an authorized platform connection into AdLiftr. Use kind=all for accounts, profiles, assets, pixels, campaigns, rules, and creative issues. Overwrites local synced records and can delete stale local rules; does not activate provider campaigns.
sync_ecommerce_reports
ChatGPTQueue daily historical reporting sync and configure automatic refresh/late-conversion lookback. Does not create or activate campaigns.
update_ad
ChatGPTUpdate ad status. Overwrites the current status; activation can deliver a public ad and incur platform spend, and pausing interrupts delivery.
update_ad_set
ChatGPTUpdate ad set/ad group status. Google ad groups also support name, bidAmount, and optimizedTargetingEnabled. Overwrites existing settings; activation can deliver public ads and incur platform spend, and pausing interrupts delivery.
update_campaign
ChatGPTUpdate campaign status. Google campaigns also support name and dailyBudget. Overwrites existing settings; activation can deliver public ads and incur platform spend, and pausing interrupts delivery.