Quickstart
Connect a Google Ads account, import it, and land on your first dashboard.
You'll create a workspace, connect Google with the adwords scope, import one or more accounts, and watch
the first sync populate the dashboard. The whole flow lives in the onboarding wizard at /onboarding.
Name your workspace
Sign in and open /onboarding. The first step creates your workspace (organization). A workspace holds the
account list and shared settings; each account you import becomes its own project.
Connect Google Ads
On the Connect Google Ads step, start the OAuth flow. You're sent to Google's consent screen for the
adwords scope; approving it returns a refresh token that is encrypted at rest (AES-256-GCM) and stored per
workspace — it is never exposed to the browser or logged.
If consent fails, you're returned with a readable error (for example access_denied or no_refresh_token).
Re-run the step; the flow always forces a fresh refresh token.
Import accounts
Once connected, the wizard lists every account your Google login can reach. Manager (MCC) accounts are shown but can't be imported — pick the leaf advertiser accounts. Importing an account creates its project and enqueues a 90-day backfill so history is available immediately.
Wait for the first sync
The backfill runs in the background worker: 90 days of metrics, all dimensions, and change history. When it
finishes you're redirected to the account's Overview at /app/[projectId].
To re-run a sync manually later, use Trigger sync in the account, or gads_trigger_sync over MCP.
Set your targets
Open Settings → Optimization and set a daily spend goal, a ROAS floor, and a CPA band. These drive the optimization plan and the safe-apply policy. See Set optimization targets.
What you get after import
Overview
Spend, clicks, conversions, CPA, and ROAS for the account, with charts.
The copilot
Ask it to analyze the account and propose changes in the AI Chat tab.
Drive it over MCP
Mint a token and operate the same account from Claude Code or claude.ai.
New campaigns created through AI Google Ads default to PAUSED. Review them, then enable them after a QA pass — the system treats every write as money-moving.