Authenticate to the Carrot Ads API using a retailer-scoped API key and query the campaigns endpoint to list existing sponsored product campaigns for the retailer
Create a new campaign by POSTing a campaign object with budget, bid strategy (cost-per-click or target ROAS), and the target product UPC or catalog item IDs
Associate the campaign with specific Instacart store pages or search keyword triggers to control placement contexts
Pull the campaign performance report endpoint daily to retrieve impressions, clicks, attributed add-to-cart events, and attributed orders for each promoted item
Adjust bids programmatically using the campaign update endpoint based on ROAS performance relative to the target threshold
Monitor the spend_to_budget_ratio to detect campaigns that are exhausting budgets too early in the day and apply dayparting or budget adjustments
Known gotchas
Attribution windows for Instacart sponsored products are typically 7-14 days; comparing campaign spend to same-day order counts understates true attributed revenue
Carrot Ads campaigns target Instacart's own catalog entity IDs, not external retailer SKUs; a catalog sync must be complete before campaign item targeting is valid
Bid changes take effect on the next fulfillment cycle; very frequent bid updates can cause oscillation rather than convergence on target ROAS
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp