Make Review-Gated Ad Changes From an External AI Agent
Let Claude Code or Codex prepare an ads mutation through Soku CLI, hand you a link to the exact pending review, and execute only after you approve that specific change on the Soku approval page.
Best for
Ad operators who want external agents to prepare deterministic account changes without granting unattended authority over live spend or conversion configuration.
Access mode
Human-approved write
The agent must stop at the review gate.
The prompt
Read https://soku.ai/cli/skill.md, connect to my Soku workspace, and prepare the requested conversion group with soku call using a precise summary. Show the returned review ID, parameters, account, and proposed effect, and give me its approve_url. Never run the approval command yourself: wait with soku review wait until I approve or deny it on that page, then verify the result once. Safety boundary: stop before execution. Continue only after the user explicitly approves the exact review, revision, account, and destination described in the pending change.
Paste this into Claude Code, Codex, Cursor, or another shell-based agent. It will pause when browser approval or a human review is required.
What you will get
The external agent prepares a specific ads change, hands over the review link and human-readable diff, and the change runs only after a human approves that exact review on the Soku approval page.
- A pending review with the exact account, parameters, summary, and review ID
- A single verified change only after explicit human authorization
Before you start
- The intended ad account and conversion actions confirmed in the active Soku workspace
- A browser signed in to Soku, where the human opens the approval link the agent hands over
Works with
Run it with Soku CLI
- 1
Confirm the target account and inputs
Resolve ambiguous accounts and conversion actions before creating any pending review.
soku workspace status - 2
Create a pending review
Submit the intended mutation with a concise summary so the review is understandable outside the agent transcript.
soku call ads create_conversion_group --summary 'create group: qualified leads' -p name='Qualified Leads' - 3
Hand over the approval link
Show the exact pending review and give the human its approve_url. They approve or deny it on the signed-in Soku approval page, not in the agent's terminal.
soku review show <review_id> - 4
Wait for the decision and verify
Wait for the human to decide instead of approving, then read back the result once without replaying the write. A denial or a failed write exits non-zero.
soku review wait <review_id>
Safety boundary
Human approval requiredThe pending review is not permission to execute. A human approves the exact review on the Soku approval page; the agent never runs soku review approve itself, and approval must never be allowlisted, replayed, or generalized to later writes.
Related Soku skills: soku-google-ads, soku-meta-ads
More Agent Workflows use cases
Audit Google Ads With Claude Code and Soku CLI
Give Claude Code read-only access to Google Ads through Soku CLI, inspect tracking, search terms, creative coverage, budgets, and Quality Score, then save an evidence-backed account audit.
Review Meta Ads Performance With Codex and Soku CLI
Connect Codex to Meta Ads reporting through Soku CLI, compare campaign and creative performance, identify fatigue and CPA changes, and return a read-only optimization brief with evidence.
Build a Weekly Cross-Channel Ads Report With an AI Agent
Use a local AI agent and Soku CLI to combine Google Ads, Meta Ads, and GA4 into one weekly report that explains changes, flags anomalies, and preserves the reporting window.
Analyze GA4 Landing Pages With Claude Code and Soku CLI
Let Claude Code query GA4 through Soku CLI, rank landing pages by traffic and conversion behavior, find paid-traffic leaks, and save an evidence-backed CRO shortlist.
