Koast API
Build on Koast with the REST API, webhooks, the MCP server and the koast command line.
The Koast API lets your own code do what your team does in the Koast app: read brands, ad accounts and live metrics, build launches, publish them to Meta or Whop, edit live budgets, run automations and workflows, and push spend into your tracker. Koast also calls you back with webhooks when a launch finishes, an ad is reviewed or a day's spend closes.
Base URL
https://api.koast.ai/v1Every brand-scoped resource lives under its brand: /v1/brands/{brandId}/…. The brand is always in the path. The API never relies on a "current brand".
The full spec is public, in OpenAPI 3.1, at https://api.koast.ai/v1/openapi.json. This site, the API reference and the koast CLI are all generated from it.
What you can build
- Reporting. Pull spend, results and daily insights per launch, campaign, ad set or ad, straight from the ad platform. See Metrics freshness.
- Launching. Create a launch, add campaigns, ad sets, ads and creatives, validate it, preview it, then publish. See Idempotency before you publish anything.
- Live changes. Edit a live budget, rename or duplicate nodes, swap creatives.
- Automation. Manage automations, workflows, templates and the creative pipeline.
- Events. Subscribe an HTTPS endpoint to launch, review, delivery and spend events. See Webhooks.
- Trackers. Turn on spend push to RedTrack or ClickFlare and fix campaign mappings. See Trackers.
Who gets access
| Surface | Plans |
|---|---|
REST API, webhooks and the koast CLI | Agency plans with an active subscription |
| MCP server (Claude, ChatGPT, Cursor and other MCP clients) | Every paid plan with an active subscription |
Other plans get 403 plan_required. See Access and plans.
Start here
- Quickstart: create a key and make your first call in a few minutes.
- Authentication: API keys, scopes, brand limits and the publish ceiling.
- Errors, Pagination and Rate limits: the rules every endpoint shares.
Reference
| Section | What's in it |
|---|---|
| API reference | Every endpoint, grouped by resource, with parameters, request and response schemas |
| Webhook events | Every event type, with its envelope and data schema |
| MCP tools | Every tool the Koast MCP server exposes, its scope and its REST equivalent |
| CLI commands | Every koast command and its flags |
| Changelog | What changed in the API, by date |
Guides
Errors, Pagination, Idempotency, Rate limits, Metrics freshness, Versioning, Webhooks, Trackers, MCP and CLI.
Getting help
Every response carries a Koast-Request-Id header, and every error repeats it as requestId. Quote it when you contact Koast support, and we can find the exact request.