add_workspace_user
ChatGPTAdd any existing Brandwave user account as a pending workspace member with the specified role. Requires workspace-owner permissions. Workspace details and stored aggregate marketing metrics become visible in the recipient's workspace list while pending; acceptance grants role-based workspace access. Does not create an account or send an email.
answer_brand_demand_moment
ChatGPTRecord what drove a month where your brand searches moved: link the activities or campaigns that ran, mark it as not your marketing, or reopen the question.
compare_campaigns
ChatGPTRetrieve the preferred comparison workflow for selected campaigns over a trailing period, including current values, historical changes, denominator-aware efficiency metrics, ISO currency, evidence quality, and plain-language findings.
connect_activity_content_link
ChatGPTLink a social media post URL to an activity to track its metrics.
connect_creator_social_account
ChatGPTAdd a public Instagram, YouTube, TikTok, X, LinkedIn or Reddit account to an existing creator by profile URL or username, and track the creator's public metrics.
count_activities
ChatGPTGet the total number of activities matching the given filters, including whether impression metrics are available or missing.
count_activity_creators
ChatGPTCount the number of creators linked to an activity.
count_expenses
ChatGPTCount the manual expense and provider-reported spend records shown in the Spend ledger, with optional Activity, creator, or Campaign filters.
create_activity
ChatGPTCreate social or provider-delivered activity with channel-specific delivery details, metrics, an initial spend or expense line, and the person or company that delivered it. Social media activity is delivered by a creator; broadcast, out-of-home, print, event, podcast, and PR activity is delivered by a media provider.
create_activity_expense
ChatGPTAdd a expense line item with net amount, currency, category, creator attribution, tax breakdown, and booking reference.
create_ai_question
ChatGPTAdd a question for Brandwave to ask ChatGPT and Google AI Overviews every month, such as "What is the best PDF editor?", to track whether the answers mention or recommend the brand and its competitors.
create_campaign
ChatGPTCreate a campaign planning record with a name, summary, objective, audience, key message, desired outcomes, planned channels, owner, tags, dates, and budget. Status is derived from its dates and the response includes a mutation receipt.
create_creator
ChatGPTCreate a new creator (influencer) within a workspace. Required: workspaceId, name. Optional: email, role (person/community/brand_partner), country (2-letter ISO code), notes.
create_expense_category
ChatGPTCreate a reusable workspace-owned expense category while adding or editing expenses.
create_file
ChatGPTCreate a text, markdown, or CSV file on a campaign, activity, or creator by supplying its content directly. Use this to save a written report, summary, plan, or notes. To keep a file someone shared with you, import it instead.
create_learning
ChatGPTRecord a learning on a campaign: its type (decision, rationale, assumption, risk, lesson and others), a title and the wording. It can also carry the original author and date, and the past learnings or source files it was based on.
create_media_provider
ChatGPTCreate a reusable media provider with an optional website and private notes for provider-delivered activities.
create_note
ChatGPTCreate a new note attached to an entity.
create_outcome_definition
ChatGPTCreate a reusable definition for a reported business or brand outcome such as sales value, awareness, or qualified inquiries, with a name, value kind, unit label, and default currency.
create_outcome_measurement
ChatGPTRecord a campaign-reported outcome measurement: the value, optional baseline value, reporting period start and end, market, source method, and confidence, stored as an append-only evidence claim.
create_owned_content
ChatGPTAdd a part of your own site to track as owned content, such as a blog at /blog, by name and URL paths. Its job is Be findable unless you choose another. Search and visit history is fetched automatically.
create_workspace
ChatGPTCreate a workspace with a name, timezone, and currency, then assign the requesting user as owner.
delete_activity
ChatGPTPermanently delete an activity and its associated records.
delete_activity_expense
ChatGPTRemove a expense line item from an activity.
delete_ai_question
ChatGPTRemove an AI question so Brandwave stops asking it each month. Its past answers are no longer listed with the workspace.
delete_campaign
ChatGPTRemove a campaign from normal use and unlink its associated activities. The response includes a customer-facing deletion receipt.
delete_creator
ChatGPTPermanently delete a creator and all associated data.
delete_expense_category
ChatGPTRemove an unused expense category; categories still used by live spend are blocked.
delete_file
ChatGPTRemove a file from the campaign, activity, or creator it is attached to.
delete_learning
ChatGPTDelete one learning. It is soft deleted and keeps its revision history.
delete_media_provider
ChatGPTDelete a media provider that has no active delivered activities linked to it.
delete_note
ChatGPTDelete a note and remove it from its parent entity.
delete_outcome_definition
ChatGPTDelete an unused reported outcome definition by soft deletion; definitions with active measurements are blocked.
delete_outcome_measurement
ChatGPTDelete a reported campaign outcome measurement by soft deletion.
delete_owned_content
ChatGPTRemove a part of your site from owned content so Brandwave stops tracking it.
delete_workspace
ChatGPTDelete a workspace by marking it deleted rather than permanently erasing its records. Requires workspace-owner permissions. Requests using Brandwave agent access tokens are rejected.
disconnect_activity_content_link
ChatGPTUnlink a post URL from an activity and stop tracking its metrics.
disconnect_search_console
ChatGPTDisconnect Search Console without disconnecting Google Analytics or deleting historical observations.
disconnect_social_account
ChatGPTDisconnect a social media account from a creator.
duplicate_campaign
ChatGPTCreate a new draft by duplicating a campaign planning brief, optionally replacing its name and dates. Activities are not copied because an activity belongs to one campaign at a time.
fetch
ChatGPTFetch the complete Brandwave record identified by a search result and return its canonical Brandwave URL with a useful structured record.
get_activity
ChatGPTRetrieve a single activity by ID with full details.
get_activity_launch_response
ChatGPTRetrieve what was happening around the time one activity went live: other activities that started in the same days, and where it sits among work of the same channel and type that year. For Convert work it also compares brand searches, sessions, results, and customers naming your marketing in the three days after launch with a usual day from the four weeks before, plus visits through promo codes and tagged links mapped to the activity. Build work returns the long_view state without that reading, because its effect shows over months. It reports timing and does not assign attribution.
get_activity_log_entry
ChatGPTRetrieve a single activity log entry by ID.
get_activity_metrics
ChatGPTFetch metrics for a single activity including impressions, engagement, spend, CPM, and CPE.
get_activity_metrics_history
ChatGPTFetch an activity's metrics over time with a configurable lookback window.
get_activity_stats
ChatGPTAggregate statistics for activities matching the given filters, including whether impression metrics are available or missing, optionally including spend and impression totals grouped by channel.
get_analytics_history
ChatGPTFetch daily Google Analytics site metrics (sessions, users, page views) and success-metric event counts for a date range, zero-filled for days without data.
get_brand_demand_ai_answers
ChatGPTGet how often ChatGPT and Google AI Overviews mention and recommend your brand and competitors, from the Brand Demand Index set your brands belong to.
get_brand_demand_config
ChatGPTFetch the workspace Brand Demand configuration, including own brand, competitors, exact terms, markets, review state, and Search Console status.
get_brand_demand_index_brand
ChatGPTRetrieve a public brand profile from the Brand Demand Index by market key and brand slug, such as "new-world": twelve months of modeled branded-search demand, its Share of Search position in each competitive set, the branded search terms measured, and the company that owns it. The brand does not need to be a Brandwave customer.
get_brand_demand_index_category
ChatGPTRetrieve one public competitive category in a market by market key and category slug: twelve months of modeled branded-search demand for each member brand, Share of Search inside the set, rank and share movement, exact search terms, sources, and limitations.
get_brand_demand_index_company
ChatGPTRetrieve a public multi-brand company portfolio from the Brand Demand Index by market key and company slug: the two or more tracked brands this company owns, the branded terms each brand is measured through, and where each brand sits in its competitive categories. Demand belongs to the brands, so the company is never given a combined figure. A single-brand owner has no separate company page.
get_brand_demand_index_comparison
ChatGPTRetrieve a head-to-head comparison of two brands inside a shared competitive set in one market: twelve months of branded-search demand, Share of Search, rank, and lead changes. Set categorySlug to compare the pair inside a particular shared set; without it, the set with the most measured demand is used. Returns not found when the pair does not share the requested set.
get_brand_demand_index_location
ChatGPTRetrieve every local competitive set about one place in a market by market key and place slug, such as "blenheim": which law firms, real estate agencies, builders, or other local businesses lead branded search there, each set with its current leaders, member count, and latest measured month.
get_brand_demand_index_location_set
ChatGPTRetrieve the competitive set at one place and topic in a market, such as "blenheim" and "law-firms" in New Zealand or "nsw" and "car-brands" in Australia: a local set measured on searches made in that place, or a national set measured in a state, region, or metro with how its leader and shares differ from the national reading. Returns the same shape as a competitive category, with the place it was read in.
get_brand_demand_index_market
ChatGPTRetrieve the public Brand Demand Index for one market key, such as "nz" for New Zealand: the market's totals, its largest competitive sets with their current Share of Search leaders, multi-brand company portfolios, and one page of the market's sets. Search the sets by name, filter them by size band (total estimated monthly searches), sort them by name, brand count, or total, and page through them.
get_brand_demand_index_overview
ChatGPTRetrieve a summary of the whole public Brand Demand Index in one call: how many markets, brands, competitive sets, and multi-brand company portfolios Brandwave publishes, the earliest and latest months measured, and the strongest branded-search movements across every market. Use this to see what changed recently anywhere in the dataset before drilling into a single market.
get_brand_demand_index_selection
ChatGPTRetrieve a comparison of any two to ten published brands in one market, even when they belong to different competitive sets: twelve months of branded-search demand for each brand and Share of Search computed among the chosen brands only. Pass the brand slugs comma-separated in brands. Shares here describe the selection, not a curated market set, and brands from another market cannot be combined. The response also carries the newest ChatGPT and Google AI Overview answers that mention these brands. Brands in one competitive set share that set's answers; brands from different sets each come with the answers for their own set, since answers are collected one set at a time.
get_brand_demand_report
ChatGPTFetch 12 complete months of estimated branded-search demand and Share of Search for one market, with optional observed Search Console metrics reported separately.
get_brandwave_context
ChatGPTReturn the authenticated user's profile, accessible workspaces, active workspace, and only the current assistant connection. Use this before answering identity, profile, workspace, or current-connection questions.
get_campaign
ChatGPTRetrieve a single campaign by ID with full details.
get_campaign_closeout
ChatGPTGenerate a campaign closeout or review with recorded performance, ISO currency, evidence quality, limitations, and recommended follow-up actions without claiming causal attribution.
get_campaign_metrics
ChatGPTFetch metrics for a single campaign including ISO currency, budget, spend, impressions, social engagement, delivery coverage, denominator-aware CPM and Social CPE, freshness, provenance, and data-quality warnings.
get_campaign_metrics_history
ChatGPTFetch campaign metrics over time with a configurable lookback window.
get_campaign_portfolio
ChatGPTRetrieve decision-ready portfolio health as the preferred starting point for broad campaign-health questions, including active, scheduled, completed, draft, and attention counts; budget and spend totals; brief completeness; evidence quality; priorities; and recommended next actions.
get_campaign_readiness
ChatGPTAssess whether a campaign is ready to launch by reviewing its summary, objective, audience, desired outcomes, planned channels, dates, owner, budget, and linked activities.
get_campaign_stats
ChatGPTAggregate statistics for campaigns matching the given filters.
get_channel_outcomes
ChatGPTRetrieve evidence by channel for a date range: each channel type with spend (social media, broadcast, out of home, print, events, podcasts, PR articles) walked across the evidence chain with spend and activity count, impressions, sessions from linked promo codes and tagged links, linked success events, and customer-reported HDYHAU mentions, plus a corroboration count of how many of the four steps hold direct evidence. Cells are null when the source that could see them is not connected. Nothing is inferred or attributed.
get_creator
ChatGPTRetrieve a single creator by ID with full details and social accounts.
get_creator_metrics
ChatGPTFetch metrics for a single creator including activity counts, follower totals, impressions, engagement, spend, CPM, and CPE.
get_creator_metrics_history
ChatGPTFetch a creator's follower count, impressions, engagement, spend, CPM, and CPE over time with a configurable lookback window.
get_creator_stats
ChatGPTAggregate statistics for creators matching the given filters.
get_direct_signal_evidence
ChatGPTRetrieve directly observed GA4 promo-code and manually tagged UTM-link evidence for a date range, including sessions, daily users, selected success outcomes, explicit creator/campaign/activity mappings, general referral-channel buckets (e.g. Facebook, Google organic, an AI assistant) with a per-bucket traffic summary, and zero-filled timeline data. This reports observed evidence and does not infer attribution.
get_file_download
ChatGPTGet a short-lived authorized URL for reading one private file, so it can be opened or fetched and analyzed.
get_following
ChatGPTRetrieve Following: how many people chose to hear more from the brand, month by month. It totals followers across the social accounts the brand posts from (YouTube subscribers and TikTok fans count as followers) at the last reading of each month, with the change on the month before, and lists each account with its latest count and how that changed since its first reading in the window. 12 calendar months by default (3-24).
get_hdyhau_evidence
ChatGPTRetrieve a summary of GA4 How Did You Hear About Us (HDYHAU) custom-dimension values for a date range, including raw responses, normalized source categories, response coverage, creator-marketing relevance, data-quality flags, and a daily evidence timeline. This does not assign conversions to creators or campaigns.
get_learning
ChatGPTGet one learning with who recorded it, the original author and date, its current revision number, and the other learnings or source files it references.
get_marketing_brief
ChatGPTCreate the preferred stakeholder-ready executive or practitioner brief for a trailing period with a headline, highlights, risks, decisions required, recommended actions, campaign evidence, ISO currency, and measurement limitations.
get_marketing_compare
ChatGPTRetrieve activities in a date range grouped by the job they do (Build, Be findable, Convert, or none yet), then by channel, with spend, activity count and impressions beside direct evidence: visits through promo codes and tagged links, and results those codes, links and customer answers named. Cost per result is given for Convert work only, because Build work shows up over months in brand searches and followers, and Be findable work in search clicks and visits. A channel's direct evidence sits with the job that spent most on it. These are observations, with no causal attribution.
get_marketing_ladder
ChatGPTRetrieve the marketing ladder for a date range, starting at the top: is the success metric moving (its count in the workspace's own words, visits through linked promo codes and tagged links, the share of customers who named marketing when asked how they found you), are people interested (brand searches a month, clicks from brand searches, followers, interest actions), did people find you (impressions, site visits, visits from search and social), and what was done (activities running in the range by job: Build, Be findable, Convert, with how many started in it and spend; work that started earlier counts while it is still live, and its spend stays with the range it started in). Each figure compares with the previous window of the same length; brand searches compare month over month. Observations only; no causal attribution.
get_marketing_long_view
ChatGPTRetrieve the long view of the marketing program: 12 calendar months by default (3-24) of what went out against the slow measures that brand work moves. Each month counts the activities that went live by job: Build (work that grows awareness over months, such as podcasts, creators and PR), Be findable (work that makes the brand show up when someone looks, such as listings and backlinks) and Convert (work that nudges people who already know the brand, such as paid ads and in-person events), the running total of Build work since the first activity, spend, modeled monthly brand searches, Share of Search against competitors, website visits, success events, and customers who named the marketing when asked how they found you. Measures whose source is not connected are null. It shows what coincided over time and does not assign attribution.
get_marketing_moments
ChatGPTRetrieve the weeks in a date range where marketing evidence moved: spend, brand search impressions, sessions, sessions from linked promo codes and tagged links, success events, or customer-reported HDYHAU marketing mentions that landed well above or below their trailing weekly median. Each moment lists the activities, campaigns, and campaign reported outcomes live that week so a reader can judge what coincided. Quiet windows return the biggest movers below the threshold instead of nothing. Read weeksEvaluated beside weeksInWindow: a week with no data behind it, or whose preceding weeks are all zero, has no baseline to be compared against and is counted in only one of them. Observations only; no causal attribution.
get_marketing_month
ChatGPTRetrieve one calendar month of the marketing record, the content of the "So what?" page: the activities that went live with their jobs (Build, Be findable or Convert) and what the month cost, thirteen months of the long view ending with that month so it can be compared with the month before and the same month last year, the weeks in the month that stood out, and the channels that showed up or stayed quiet and the blind spots over the three months to its end. It also says whether a read-only link to the page is live. Observations only; it does not assign attribution.
get_marketing_recommendations
ChatGPTRetrieve the preferred next-decision workflow with deterministic evidence-backed recommendations about what to investigate, maintain, or consider, including priority, confidence, rationale, supporting evidence, and campaign links.
get_marketing_summary
ChatGPTAssess whether marketing is working for a date range using the evidence chain: spend (spend, activities, campaigns, delivery coverage), awareness (modeled brand search volume, Share of Search, impressions, Search Console brand impressions), traffic (sessions, users, sessions from linked promo codes and tagged links), and results (success-event counts, customer-reported HDYHAU attribution share, campaign reported outcomes). Spend, traffic, and results figures compare the window with the previous window of the same length; brand search volume is a monthly estimate compared with the month before it, which its own comparison field states. Coverage gaps name the connections or data that would sharpen the picture. Returns figures, not a verdict sentence. Evidence only; no causal attribution.
get_marketing_timeline
ChatGPTRetrieve the marketing record week by week, a few calendar months at a time, newest first: what ran each week (activities and campaigns), what it cost, and what moved (brand search impressions, sessions, visits from linked promo codes and tagged links, success events such as sign ups, and customers naming the marketing when asked how they heard about you). Each week carries the usual level of every series from the weeks before it and flags the ones that moved well above or below it. Use nextEndDate to page back to the start of the record. Observations only; no causal attribution.
get_marketing_verdict
ChatGPTGet Brandwave's reading of whether marketing is working for a date range: weeks that stood out because an outcome (brand search, sessions, linked visits, success events, customers naming the marketing) rose clearly above usual, with the activities that started in them; channels that showed up because promo codes, tagged links or customer answers name them; Convert channels (paid media) with spend that have been quiet so far, while Build channels are left to the long view because their effect shows over months; and the blind spots, meaning sources to connect or set up for a fuller reading. Each statement carries its rule, a confidence word (high, medium, low) and the signals it read. Fixed rules over the record, not a model, and coincidence in time rather than causal attribution.
get_media_provider
ChatGPTGet a media provider with delivered activity, spend, and impression totals.
get_media_provider_stats
ChatGPTGet spend, delivery coverage, weighted CPM, and attention statistics for media providers.
get_metric_confidence
ChatGPTAssess the statistical confidence of an activity's metrics.
get_note
ChatGPTRetrieve a single note by ID.
get_organization
ChatGPTRetrieve an organization with the workspaces the user can open, each with its share of search, unexplained moments and activities this month, and its people.
get_organization_monthly_reports
ChatGPTRetrieve one month for every workspace in the organization the user belongs to: what went out, how brand searches, Share of Search, visits and results compare with the month before and a year earlier, and each workspace share link. Month defaults to last month.
get_owned_content_performance
ChatGPTRetrieve how each piece of owned content did, month by month: Google search impressions and clicks for its pages, clicks from searches that named your brand, visits that started on it, and the success metric and interest actions in those visits. Search Console leaves rare searches out of query-level figures, so branded clicks are a lower bound, and success metric counts from GA4 are a rough guide. 12 calendar months by default (3-24).
get_paid_media_performance
ChatGPTRetrieve an imported Activity’s provider account, campaign, ad set or ad group, creative assets and text, destinations, and dated spend and delivery. Conversions and action values are provider-attributed evidence, not canonical business outcomes. Older Google observations may cover whole calendar months.
get_plan_usage
ChatGPTRetrieve current plan usage and enforced limits for a workspace across all limited resources.
get_site_visits
ChatGPTRetrieve visits to the site (GA4 sessions) month by month, split by where they came from using GA4 default channel groups such as Organic Search, Direct, Referral and Organic Social, with the totals for each source across the window, and the clicks from searches for the brand by name over the same months (from Search Console, null when it has no data). Those clicks are part of Organic Search. siteTraffic says whether Google Analytics is connected, still on its first sync, or no longer connected. 12 calendar months by default (3-24).
get_spend_history
ChatGPTFetch daily recorded marketing spend and a running cumulative total for a date range. Each spend is attributed to the day its activity ran (publish date for social content, start date for other channels) and days without spend are zero-filled, so budget and spend read alongside traffic and brand signals on one timeline.
get_spend_stats
ChatGPTAggregate total spend, spend coverage, non-campaign spend, and largest category using the active spend filters.
get_success_metric
ChatGPTGet the workspace's success metric: the one number it treats as success, in its own words (sign ups, purchases, booked meetings), and the GA4 event that counts it when one is linked. Name is null until the workspace says what success is.
get_user
ChatGPTRetrieve a single user by ID.
get_user_settings
ChatGPTRetrieve a user's personal settings.
get_workspace
ChatGPTRetrieve a single workspace by ID.
get_workspace_metrics
ChatGPTFetch workspace-level metrics including total expenses, impressions, social engagement, delivery coverage, and denominator-aware CPM and Social CPE.
get_workspace_metrics_history
ChatGPTFetch workspace metrics over time with a configurable lookback window.
get_workspace_refresh_status
ChatGPTRetrieve whether workspace metrics are currently updating.
import_file
ChatGPTAdd the original of a file someone shared, such as a spreadsheet, PDF, slide deck, document or screenshot, to a campaign, activity, or creator. Brandwave downloads the file from its link and stores a private copy.
invite_workspace_user
ChatGPTInvite a user to a workspace by email.
link_activity_creator
ChatGPTAssociate a creator with an activity.
link_campaign_activity
ChatGPTLink an activity to a campaign.
list_activities
ChatGPTRetrieve a paginated list of activities for a workspace, filterable by campaign, creator, channel, status, date range, and whether impression metrics are available or missing.
list_activity_creators
ChatGPTList creators linked to an activity with pagination.
list_activity_log
ChatGPTList activity log entries with structured filtering. Use entityType to filter by category (e.g. "creator", "campaign", "activity") and action to filter by what happened (e.g. "created", "deleted", "updated", "linked"). This is the preferred action for questions like "show creator entries" or "show deletions".
list_ai_questions
ChatGPTList the questions a workspace asks ChatGPT and Google AI Overviews each month, with the latest answers and which of its brand and competitors each answer mentions or recommends, in order.
list_brand_demand_index_locations
ChatGPTList the places in a market that have local competitive sets in the public Brand Demand Index, such as Blenheim or Queenstown in New Zealand: each place with the sets about it, for example law firms or real estate agencies in that town, and whether each set is published. Local services are measured on searches made in that place.
list_brand_demand_index_markets
ChatGPTList every country and region covered by the public Brand Demand Index, such as New Zealand, with how many competitive sets, brands, and multi-brand company portfolios each one publishes and how recent the data is. Use this to discover which market keys are available before requesting a market, brand, category, or company.
list_brand_demand_moments
ChatGPTList the months where searches for your own brand rose or fell well outside their usual level, each with what your team said ran that month or that it was not your marketing.
list_campaigns
ChatGPTRetrieve a paginated list of campaigns for a workspace, ordered by name, dates, budget, or totals.
list_creators
ChatGPTRetrieve a paginated list of creators for a workspace, ordered by name, totals, or efficiency.
list_expense_categories
ChatGPTList reusable expense categories with usage counts and recorded spend, ordered by any column.
list_expenses
ChatGPTList manual expense records and read-only provider-reported advertising spend across Activities. Provenance distinguishes editable expenses from retained platform measurements. Sort the combined ledger before pagination.
list_files
ChatGPTList the files attached to one campaign, activity, or creator, including who added each file and whether a person uploaded it or an AI assistant wrote it.
list_integrations
ChatGPTList the integration providers Brandwave offers, including ones not yet available, with the workspace’s connection state, the sources selected through each connection (site traffic, success events, search performance) and their sync status, and a coverage map of which evidence kinds currently have a live source.
list_interest_actions
ChatGPTList the GA4 events the workspace tracks as interest actions: things a visitor chose to do on the site that are not yet the success metric, such as joining a waitlist, downloading a guide or viewing pricing.
list_learning_revisions
ChatGPTList every revision of one learning, including changes to its type, title, wording, attribution and references, so a correction can be told apart from the original wording.
list_learnings
ChatGPTList one campaign's learnings: its decisions, rationale, assumptions, risks, lessons and recommendations for next time.
list_media_providers
ChatGPTList providers that organized, published, sold, or delivered marketing activity, ordered by any column.
list_notes
ChatGPTList notes for an entity, ordered by most recent first.
list_organizations
ChatGPTList the organizations the current user belongs to, with their role, plan and number of workspaces.
list_outcome_definitions
ChatGPTList reusable reported outcome definitions for a workspace.
list_outcome_measurements
ChatGPTList reported outcome measurements for a campaign, including method, period, confidence, units, and definition.
list_owned_content
ChatGPTList the owned content on your site, such as a blog or guides section, with the URL paths that define each one, its job and when it started.
list_paid_media_accounts
ChatGPTList selected advertising accounts for the Google or Meta provider, their currencies, synchronization progress, errors, and retained historical connection state for a workspace.
list_search_console_sites
ChatGPTList Search Console properties available to the authorized Google account.
list_sparklines
ChatGPTFetch sparkline chart data for one or more activities.
list_success_metric_dimension_options
ChatGPTList registered GA4 event-scoped custom dimensions and recent values for selected success events.
list_success_metric_options
ChatGPTList selectable success-metric options for the connected Google account: GA4 key events, recently seen GA4 events, and Google Tag Manager tags.
list_users
ChatGPTList users in a workspace with pagination and name search.
list_workspace_todos
ChatGPTList what needs doing in a workspace right now: promo codes and tagged links to link to marketing, customer answers to group, ended campaigns with no learnings written up, and results to choose once analytics is connected. Each item clears itself once done.
list_workspace_users
ChatGPTList users in a workspace with pagination and search.
list_workspaces
ChatGPTList workspaces the current user belongs to, with membership details.
open_own_brand
ChatGPTGet the record for your own brand as a poster, creating it the first time. Connect your brand's own social accounts to it and Brandwave adds each new post as an activity posted by your brand. Link it to an activity to record something your brand posted itself. It never appears in creator lists unless you filter by the own_brand role.
preview_campaign_mutation
ChatGPTRetrieve a no-write preview of the exact customer-facing target, desired outcomes, budget, changed fields, derived status, and warning for a campaign create, update, delete, or duplicate action.
remove_integration_source
ChatGPTRemove one selected evidence source (site traffic, success events, or search performance) so it stops syncing, without disconnecting the provider. History is retained and the source can be reselected later.
remove_workspace_user
ChatGPTRemove an existing workspace membership or pending invitation by marking it deleted. Requires workspace-owner permissions; cannot remove yourself. Does not delete the user account or send a notification.
replace_interest_actions
ChatGPTUpdate the full set of GA4 events tracked as interest actions. Events left out stop being tracked and their synced counts are removed. History for new events is backfilled automatically. The event that counts the success metric cannot also be an interest action.
replace_success_metric_dimensions
ChatGPTSelect which registered GA4 custom dimensions to read for the success metric's event, such as a "how did you hear about us" answer, and backfill their counts.
search
ChatGPTSearch a workspace for campaigns, creators, activities across every channel, and media providers by name or activity caption. Returns a small ranked result set for global navigation and record discovery.
search_activity_log
ChatGPTSearch activity log entry content using full-text matching across names, titles, and descriptions inside changes and metadata. Use this when looking for specific text in the data values, e.g. a creator name or activity title. Do NOT use this to filter by entity type or action. Use list-activity-log with entityType/action filters instead.
search_learnings
ChatGPTSearch learnings across every campaign in the workspace by text and type, so a past lesson or decision turns up without knowing which campaign it came from.
select_search_console_site
ChatGPTSelect a Search Console property by site URL and start the initial branded-query backfill.
set_direct_signal_ignored
ChatGPTIgnore one discovered GA4 promo code or manually tagged UTM link as noise, or restore a previously ignored one. Ignored signals are hidden from the default reporting view and excluded from its headline counts, but retain their observed sessions, users, and outcomes and can be restored at any time. This changes triage state only and does not infer attribution.
set_success_metric
ChatGPTUpdate the workspace's success metric: its name in the workspace's own words and, optionally, the GA4 event that counts it. Linking a different event stops tracking the old one and removes its synced counts. An event tracked as an interest action becomes the success metric instead. Event history is backfilled automatically.
submit_feedback
ChatGPTSubmit a written product feedback message directly to the Brandwave founders with authenticated-user attribution and active-workspace context. Browser submissions may also include uploaded images or screen recordings.
unlink_activity_creator
ChatGPTRemove a creator association from an activity.
unlink_campaign_activity
ChatGPTUnlink an activity from a campaign.
update_activity
ChatGPTUpdate an activity's channel, content link, metrics, media provider, or channel-specific delivery details.
update_activity_expense
ChatGPTUpdate a expense line item's net, gross, discount, and tax amounts, category, creator attribution, description, or booking reference.
update_brand_demand_config
ChatGPTUpdate the active Brand Demand own brand, competitors, exact terms, and markets by replacing the configuration. Owners only.
update_campaign
ChatGPTUpdate a campaign's planning brief, desired outcomes, owner, tags, budget, or dates. Status is derived from its dates and the response identifies the changed fields.
update_creator
ChatGPTUpdate a creator profile including role, country, and private notes.
update_expense_category
ChatGPTUpdate a reusable expense category name across every spend that uses it.
update_file
ChatGPTUpdate the name of a file attached to a campaign, activity, or creator so it says what the document actually is.
update_learning
ChatGPTUpdate the title, wording, type, author, authored date or references of one learning, recorded as a new revision. Pass expectedRevisionNumber to get a conflict back instead of overwriting a change someone else saved first.
update_media_provider
ChatGPTUpdate a media provider name, website, or private notes.
update_note
ChatGPTUpdate a note's content.
update_outcome_definition
ChatGPTUpdate the name, description, value kind, unit label, or default currency of a reusable reported outcome definition.
update_outcome_measurement
ChatGPTUpdate the value, baseline, period start and end, market, source method, or confidence of a reported outcome measurement, superseding its prior evidence claim when the value changes.
update_owned_content
ChatGPTUpdate owned content's name, URL paths, job or start date. Changing the paths fetches its search and visit history again.
update_user
ChatGPTUpdate a user's profile information. Updatable fields: name (display name), email, jobRole (e.g. 'Head of Marketing'), avatarKey (storage key, null to remove). Only include the fields you want to change. Requests using Brandwave agent access tokens can update only the token owner's profile and cannot change email or other sign-in identity details.
update_user_settings
ChatGPTCreate or update a user's settings, including switching the active workspace and managing UI preferences.
update_workspace
ChatGPTUpdate a workspace's name, avatar, timezone, currency, or country.
update_workspace_user_role
ChatGPTUpdate the role on an existing workspace membership or pending invitation. Requires workspace-owner permissions; cannot change your own role. Does not add a new membership or send a notification.
upsert_direct_signal_mapping
ChatGPTUpdate one discovered GA4 promo code or manually tagged UTM link by mapping it to exactly one Brandwave creator, campaign, or activity, grouping it under one general referral-channel bucket (e.g. Facebook, Google organic, an AI assistant) when it cannot be tied to a specific entity, or removing its existing mapping. The association is mutually exclusive, applies to all observed sessions, users, and outcomes for that signal, and does not infer causal attribution.
upsert_hdyhau_mapping
ChatGPTCreate or update a reusable workspace-specific mapping that normalizes one raw GA4 HDYHAU response value for a dimension API name into a source label and category for future reporting. This changes classification only and does not assign attribution.
