Meta Ads Write
User wants to add ANOTHER catalog ad to an existing catalog ad set — e
POST https://api.adspirer.ai/api/v1/tools/add_meta_catalog_ad/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 |
|---|---|---|
ad_set_id | string required | The existing catalog ad set ID to add the ad to. |
product_set_id | string required | Product set for this ad's creative (required). |
primary_text | string required | Primary ad text. |
headline | string optional | Headline (defaults to {{product.name}}). |
description | string optional | Description (defaults to {{product.current_price}}). |
call_to_action | string optional | CTA button type. default: "SHOP_NOW" |
landing_page_url | string optional | Storefront URL (derived from the catalog if omitted). |
facebook_page_id | string optional | Facebook Page ID (auto-detected). |
instagram_account_id | string optional | Instagram account ID (auto-detected). |
ad_name | string optional | Custom ad name. |
ad_account_id | string optional | Meta ad account ID. Auto-detected if omitted. |
{
"arguments": {
"ad_set_id": "string",
"product_set_id": "string",
"primary_text": "string",
"headline": "string",
"description": "string",
"call_to_action": "SHOP_NOW",
"landing_page_url": "string",
"facebook_page_id": "string",
"instagram_account_id": "string"
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for add_meta_catalog_ad)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "add_meta_catalog_ad"
}
{
"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": "add_meta_catalog_ad"
}
{
"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": "add_meta_catalog_ad",
"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