Amazon Ads Write
Create a complete Sponsored Products campaign: campaign → ad group → product ads (your ASINs/SKUs) → keywords (MANUAL only)
POST https://api.adspirer.ai/api/v1/tools/create_amazon_sp_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 |
|---|---|---|
profile_id | string optional | Amazon Ads profile ID (advertiser account). Omit to use the user's selected account. Find IDs with list_amazon_profiles. |
name | string required | Campaign name |
daily_budget | number required | Daily budget in the account currency (min 1.00 for most marketplaces) |
targeting_type | string optional | 'AUTO' (Amazon picks targets from the product listing) or 'MANUAL' (you provide keywords) default: "AUTO" |
state | string optional | 'ENABLED' or 'PAUSED'. Default PAUSED so the customer can review before spend starts. default: "PAUSED" |
start_date | string optional | YYYY-MM-DD (default today) |
end_date | string optional | YYYY-MM-DD (optional, runs indefinitely if omitted) |
asins | array optional | ASINs to advertise (vendors) |
skus | array optional | Seller SKUs to advertise (sellers). Provide asins OR skus. |
default_bid | number optional | Ad-group default bid default: 0.75 |
keywords | array optional | MANUAL only: [{text, match_type: EXACT|PHRASE|BROAD, bid?}] |
{
"arguments": {
"name": "string",
"daily_budget": 1.0,
"profile_id": "string",
"targeting_type": "AUTO",
"state": "PAUSED",
"start_date": "string",
"end_date": "string",
"asins": [
"string"
]
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for create_amazon_sp_campaign)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "create_amazon_sp_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_amazon_sp_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_amazon_sp_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: Amazon Ads · All tools
Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai