Walmart Connect Write
Create one or more Sponsored-Products campaigns for a Walmart advertiser
POST https://api.adspirer.ai/api/v1/tools/create_walmart_campaign/execute
Authorization: Bearer sk_live_... — your Adspirer API key (required)Content-Type: application/json (required)Idempotency-Key: <uuid> — recommended for write operations to make retries safeAll tool arguments are wrapped in an arguments object.
| Field | Type | Description |
|---|---|---|
advertiser_id | string optional | Walmart Advertiser ID. Optional when only one advertiser is connected. |
name | string optional | Campaign name (≤255 chars). For a single campaign. |
targeting_type | string optional | auto or manual targeting. one of: auto, manual |
daily_budget | number optional | Daily budget in USD (1P ≥ $50, 3P ≥ $10). |
start_date | string optional | Start date yyyy-MM-dd (campaign goes live PST midnight). |
status | string optional | Create status (default paused). one of: enabled, paused, completed |
budget_type | string optional | daily (default) or both (daily + total). one of: daily, both |
total_budget | number optional | Total budget in USD (required when budget_type=both; 1P ≥ $100, 3P ≥ $50). |
end_date | string optional | End date yyyy-MM-dd (omit for indefinite). |
rollover | boolean optional | Budget rollover (only true is accepted today). |
bidding_strategy | string optional | SP bidding strategy (default FIXED). one of: FIXED, DYNAMIC, TROAS |
campaign_options | array optional | Optional brand-term / complementary opt-outs (auto SP). |
campaigns | array optional | Multiple campaigns at once; each object takes the same fields as above. |
{
"arguments": {
"targeting_type": "auto",
"status": "enabled",
"budget_type": "daily",
"bidding_strategy": "FIXED"
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for create_walmart_campaign)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "create_walmart_campaign"
}
{
"success": false,
"error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n - Acme Holdings (ad_account_id=\"act_123456789\")\n - Acme EU (ad_account_id=\"act_987654321\")",
"is_error": true,
"tool": "create_walmart_campaign"
}
{
"success": false,
"error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
"is_error": true,
"tool": "create_walmart_campaign",
"quota": {
"used": 150,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01",
"upgrade_url": "https://adspirer.ai"
}
}
Interactive: Swagger UI
Machine-readable: OpenAPI 3.1 spec · llms-full.txt
More tools: Walmart Connect · All tools
Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai