Google Ads Write
🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the upgrade link) - DO NOT attempt to work ar
POST https://api.adspirer.ai/api/v1/tools/update_conversion_action/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 |
|---|---|---|
conversion_action_id | string required | The conversion action ID to update. Get it from list_conversion_actions or audit_conversion_tracking. |
name | string optional | New display name. |
category | string optional | New category: PURCHASE, SIGNUP, ADD_TO_CART, BEGIN_CHECKOUT, SUBMIT_LEAD_FORM, BOOK_APPOINTMENT, REQUEST_QUOTE, GET_DIRECTIONS, ENGAGEMENT, CONTACT, PHONE_CALL_LEAD, OUTBOUND_CLICK, QUALIFIED_LEAD, CONVERTED_LEAD, DOWNLOAD, PAGE_VIEW, SUBSCRIBE_PAID, IMPORTED_LEAD, STORE_VISIT, STORE_SALE, DEFAULT. |
status | string optional | New status: ENABLED or PAUSED. (This tool never removes a conversion action.) |
value | number optional | New default conversion value in the ACCOUNT'S currency as a decimal (not cents, not USD). E.g. 50 for 50/lead. |
currency_code | string optional | 3-letter currency code for the value (USD, EUR, ...). |
always_use_default_value | boolean optional | If True, every conversion is worth `value` regardless of what the tag sends. Requires value > 0. |
counting_type | string optional | ONE_PER_CLICK (lead-gen) or MANY_PER_CLICK (e-commerce). |
click_through_lookback_window_days | integer optional | 1-30. |
view_through_lookback_window_days | integer optional | 1-30. |
include_in_conversions_metric | boolean optional | Whether this action counts in the 'Conversions' metric Smart Bidding optimizes toward. |
primary_for_goal | boolean optional | Whether this is a primary conversion action for its goal. |
attribution_model | string optional | Attribution model: GOOGLE_ADS_LAST_CLICK, GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN, GOOGLE_SEARCH_ATTRIBUTION_LINEAR, GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY, GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED, GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK, EXTERNAL. |
customer_id | string optional | Google Ads customer ID. Required for multi-account users. Get from get_connections_status. |
{
"arguments": {
"conversion_action_id": "string",
"name": "string",
"category": "string",
"status": "string",
"value": 1.0,
"currency_code": "string",
"always_use_default_value": false
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for update_conversion_action)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "update_conversion_action"
}
{
"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": "update_conversion_action"
}
{
"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": "update_conversion_action",
"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: Google Ads · All tools
Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai