List promo windows
Lists the active brand's promo windows, the sales the user entered in Koast: name, first and last day, how many days of aftermath follow, and whether each is coming up, running, in its aftermath or over.
Tool name: list-promo-windows.
Lists the active brand's promo windows, the sales the user entered in Koast: name, first and last day, how many days of aftermath follow, and whether each is coming up, running, in its aftermath or over. Read-only.
When to use
Before judging a spike or a dip in results, to check whether a planned sale or the quiet days after it explain it.
Access
| Property | Value |
|---|---|
| Required scope | read |
| Publishes | No |
| Read-only | Yes |
| Destructive | No |
| Idempotent | Yes |
| Open world | No |
Input
| Field | Type | Required | Description |
|---|---|---|---|
includePast | boolean | No | True to also list promos whose aftermath has ended. Default false: only promos running now, in their aftermath, or coming up. |
Output
| Field | Type | Required | Description |
|---|---|---|---|
asOf | string | Yes | The brand's own calendar day the timings are judged on, in its ad account's time zone, YYYY-MM-DD. |
includePast | boolean | Yes | |
windows | object[] | Yes |
REST equivalent
MCP only. No REST operation does the same thing.
List daily suggestions
Lists the daily suggestions Koast raised on Home for the active brand: each card's kind (pause, lower or raise a budget, a note), its state, title, reason with its numbers and date ranges, expected effect, when it expires, and the result once a person decided it.
Preview ads
Preview a campaign launch's ads as they appear in feed: primary text, headline, call to action and the creative image for every ad in the launch, in structure order.