Google Ads / API Reference
google_ads_upload_offline_conversions
Google Ads tool. Prefer the actions marked RECOMMENDED for everyday Google Ads workflows. Upload offline conversion events to Google Ads (click-based conversions via GCLID). Use this to import CRM leads, phone call outcomes, or any conversion that happened offline after an ad click. Google uses GCLID to match the click. Args: conversions: List of conversion dicts. Each requires: - gclid: The Google Click ID from the landing page URL parameter. - conversion_action_id: ID of the conversion action to import into. - conversion_date_time: ISO datetime with timezone (e.g. '2024-01-15 14:30:00+00:00'). - value: Optional float conversion value. - currency: Optional currency code (default 'USD'). customer_id: Google Ads customer ID. Leave blank to use default. Example: conversions=[{ "gclid": "Cj0KCQjw...", "conversion_action_id": "12345678", "conversion_date_time": "2024-01-15 14:30:00+00:00", "value": 250.00, "currency": "USD" }]
This is a write tool: it uploads offline conversions in your Google Ads account. Claude asks you to confirm before it runs.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Upload offline conversions in my Google Ads account for [conversions].
It takes 1 required and 1 optional parameter.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
conversions | array | Yes | Conversions |
customer_id | string | No | Customer Id |
Related Google Ads tools
google_ads_upload_customer_matchgoogle_ads_upload_image_assetgoogle_ads_account_overviewgoogle_ads_ad_performancegoogle_ads_ad_schedule_reportgoogle_ads_add_adgroup_negative_keywords
Before you can call it
This tool needs a connected Google Ads account. The Google Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account: