Meta Ads Write
User wants to advertise a SUBSET of their catalog — "boost just these items / these SKUs", "promote my sale items", "make a set of my new arrivals"
POST https://api.adspirer.ai/api/v1/tools/create_meta_product_set/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 |
|---|---|---|
catalog_id | string required | Product catalog ID the set belongs to (required). Get it from list_meta_catalogs. |
name | string required | Name for the new product set (e.g. 'Summer Sale', 'Footwear'). |
retailer_ids | array optional | List of product retailer IDs / SKUs to include (e.g. ['SKU-001','SKU-002']). Use this to 'boost just these items'. Either retailer_ids or filter is required. |
filter | object optional | Advanced: a raw Meta product-set filter dict, e.g. {'product_type': {'i_contains': 'shoes'}}. Overrides retailer_ids if both are given. |
ad_account_id | string optional | Meta ad account ID. If not provided, uses the connected account. |
{
"arguments": {
"catalog_id": "string",
"name": "string",
"retailer_ids": [],
"filter": {},
"ad_account_id": "string"
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for create_meta_product_set)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "create_meta_product_set"
}
{
"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_meta_product_set"
}
{
"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_meta_product_set",
"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
Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai