Google Merchant Center / API Reference
merchant_insert_promotion
Merchant Center tool. Create or replace a promotion. Promotions need a promotion data source and are reviewed by Google. Args: account_id: Merchant Center account id. promotion_id: Your unique promotion id. data_source: A promotion data source id (merchant_list_data_sources). promotion: JSON object of promotion attributes, e.g. '{"longTitle": "20% off shoes", "productApplicability": "ALL_PRODUCTS", "offerType": "NO_CODE", "couponValueType": "PERCENT_OFF", "percentOff": 20, "promotionEffectiveTimePeriod": {"startTime": "2026-10-01T00:00:00Z", "endTime": "2026-10-31T23:59:59Z"}}'. content_language: Two-letter language. Default 'en'. target_country: Two-letter country. Default 'US'. redemption_channel: ONLINE or IN_STORE. Default ONLINE.
This is a read-only tool: it returns merchant insert promotion for your Google Merchant Center account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Merchant insert promotion in my Google Merchant Center account for [promotion id], [data source], [promotion].
It takes 4 required and 3 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | Account Id |
promotion_id | string | Yes | Promotion Id |
data_source | string | Yes | Data Source |
promotion | string | Yes | Promotion |
content_language | string | No | Content Language |
target_country | string | No | Target Country |
redemption_channel | string | No | Redemption Channel |
Related Google Merchant Center tools
merchant_insert_local_inventorymerchant_insert_productmerchant_insert_regional_inventory
Before you can call it
This tool needs a connected Google Merchant Center account. The Google Merchant Center connect guide covers how to authorize it and what it unlocks, and the quickstart gets a client talking to the server in about five minutes.
Start free — 30 tool calls a month
No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.