Expenses
See how an AI assistant can help with expenses in Brandwave, including example prompts and the details it may ask for.
Using your AI assistant
List expenses
List 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.
Tool name: list_expenses. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt
List all expenses in my workspace.Details to provide
| Name | Type | Required | Description |
|---|---|---|---|
| pageIndex | integer | Required | Zero-based page index for pagination. |
| pageSize | integer | Required | Number of items per page (1-100). |
| dateFrom | string | — | Earliest date to include, as YYYY-MM-DD in the workspace timezone. |
| dateTo | string | — | Latest date to include, as YYYY-MM-DD in the workspace timezone. Use the same date as dateFrom for a single day. |
| workspaceId | string (UUID) | Required | Workspace identifier. |
| activityId | string (UUID) | — | Filter by activity identifier. |
| creatorId | string (UUID) | — | Filter by creator identifier. |
| campaignId | string (UUID) | — | Filter by campaign identifier. |
| searchTerm | string | — | Search expense category, description, or activity name. |
| categoryId | string (UUID) | — | Filter by expense category identifier. |
| sortBy | 'amount' | 'createdAt' | — | Expense field to sort by. |
| sortDirection | 'asc' | 'desc' | — | Sort direction: ascending or descending. |
What you'll get back
Returns { items, totalCount, facets, _meta } with paginated results.
Count expenses
Count the manual expense and provider-reported spend records shown in the Spend ledger, with optional Activity, creator, or Campaign filters.
Tool name: count_expenses. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt
How many expenses do I have?Details to provide
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| activityId | string (UUID) | — | Filter by activity identifier. |
| creatorId | string (UUID) | — | Filter by creator identifier. |
| campaignId | string (UUID) | — | Filter by campaign identifier. |
What you'll get back
Returns { count, _meta }.
Get spend stats
Aggregate total spend, spend coverage, non-campaign spend, and largest category using the active spend filters.
Tool name: get_spend_stats. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt
Show me the details for this spend stats.Details to provide
| Name | Type | Required | Description |
|---|---|---|---|
| dateFrom | string | — | Earliest date to include, as YYYY-MM-DD in the workspace timezone. |
| dateTo | string | — | Latest date to include, as YYYY-MM-DD in the workspace timezone. Use the same date as dateFrom for a single day. |
| workspaceId | string (UUID) | Required | Workspace identifier. |
| activityId | string (UUID) | — | Unique identifier (UUID v4). |
| creatorId | string (UUID) | — | Unique identifier (UUID v4). |
| campaignId | string (UUID) | — | Unique identifier (UUID v4). |
| searchTerm | string | — | |
| categoryId | string (UUID) | — | Unique identifier (UUID v4). |
What you'll get back
Returns { data, _meta } with the result.
Get spend history
Fetch 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.
Tool name: get_spend_history. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt
Show me the details for this spend history.Details to provide
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| startDate | string | Required | First day of the range (YYYY-MM-DD, inclusive). |
| endDate | string | Required | Last day of the range (YYYY-MM-DD, inclusive). |
What you'll get back
Returns { items, totalCount, facets, _meta } with paginated results.