Insert Promotion - Markifact

Inserts or replaces a promotion (sale, discount, or coupon) in a Merchant Center promotion data source. Re-inserting the same promotionId replaces the promotion.


App	Google Merchant Center
Operation ID	`gmc_insert_promotion`
Type	Action
Connection	`gmc` (required)
Credits per run	1
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
`account`	DynamicAccount	Yes	-	Select the Merchant Center account in which to insert the promotion.
`data_source_id`	string or SelectItem	Yes	-	Promotion API data source ID. Create one with gmc_create_data_source using a promotionDataSource input.
`promotion`	object or string	Yes	-	Official Google Merchant API Promotion body as an object or JSON string, sent as-is. Use Google’s REST camelCase field names exactly. Required fields per Google: promotionId, contentLanguage, targetCountry, redemptionChannel, and attributes with longTitle, offerType, couponValueType, productApplicability, genericRedemptionCode (for GENERIC_CODE offers), and promotionEffectiveTimePeriod startTime/endTime. Inserting with an existing promotionId replaces the promotion. Example: {“promotionId”: “summer_sale_20”, “contentLanguage”: “en”, “targetCountry”: “US”, “redemptionChannel”: [“ONLINE”], “attributes”: {“longTitle”: “20% off all shirts”, “offerType”: “GENERIC_CODE”, “genericRedemptionCode”: “SUMMER20”, “couponValueType”: “PERCENT_OFF”, “percentOff”: “20”, “productApplicability”: “ALL_PRODUCTS”, “promotionEffectiveTimePeriod”: {“startTime”: “2026-08-01T00:00:00Z”, “endTime”: “2026-08-31T23:59:59Z”}}}

SelectItem

Field	Type	Required	Default	Description
`value`	string	Yes	-	The value of the selectable item.
`label`	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

Output

Type: Dict Returns the inserted promotion. Fields: promotion