Brandwave

Count the manual expense and provider-reported spend records shown in the Spend ledger, with optional Activity, creator, or Campaign filters.

count_expenses

Create 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

Add a expense line item with net amount, currency, category, creator attribution, tax breakdown, and booking reference.

create_activity_expense

Create 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_campaign

Create a new creator (influencer) within a workspace. Required: workspaceId, name. Optional: email, role (person/community/brand_partner), country (2-letter ISO code), notes.

create_creator

Create a reusable workspace-owned expense category while adding or editing expenses.

create_expense_category

Create 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_file

Record 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_learning

Create a reusable media provider with an optional website and private notes for provider-delivered activities.

create_media_provider

Create a new note attached to an entity.

create_note

Create 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_definition

Record 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_outcome_measurement

Create a workspace with a name, timezone, and currency, then assign the requesting user as owner.

create_workspace

Permanently delete an activity and its associated records.

delete_activity

Remove a expense line item from an activity.

delete_activity_expense

Remove a campaign from normal use and unlink its associated activities. The response includes a customer-facing deletion receipt.

delete_campaign

Permanently delete a creator and all associated data.

delete_creator

Remove an unused expense category; categories still used by live spend are blocked.

delete_expense_category

Remove a file from the campaign, activity, or creator it is attached to.

delete_file

Delete one learning. It is soft deleted and keeps its revision history.

delete_learning

Delete a media provider that has no active delivered activities linked to it.

delete_media_provider

Delete a note and remove it from its parent entity.

delete_note

Delete an unused reported outcome definition by soft deletion; definitions with active measurements are blocked.

delete_outcome_definition

Delete a reported campaign outcome measurement by soft deletion.

delete_outcome_measurement

Delete a workspace by marking it deleted rather than permanently erasing its records. Requires workspace-owner permissions. Requests using Brandwave agent access tokens are rejected.

delete_workspace

Unlink a post URL from an activity and stop tracking its metrics.

disconnect_activity_content_link

Disconnect Search Console without disconnecting Google Analytics or deleting historical observations.

disconnect_search_console

Disconnect a social media account from a creator.

disconnect_social_account

Create 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.

duplicate_campaign

Fetch the complete Brandwave record identified by a search result and return its canonical Brandwave URL with a useful structured record.

fetch

Retrieve 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_brand

Retrieve 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_category

Retrieve 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_company

Retrieve 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_comparison

Retrieve 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

Retrieve 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_market

Retrieve 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_overview

Retrieve 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_location_set

Return 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_brandwave_context

Retrieve 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_hdyhau_evidence