meta_ads_products_update
Update one or more fields of an existing Meta Ads catalog product. Partial update — only supplied fields are changed, and rollback restores prior values.
Instructions
Updates one or more fields on an existing catalog product. Partial update — only supplied fields are changed. Returns the updated product. Mutating, reversible via rollback_apply (rollback restores prior field values). For availability toggles (in stock ↔ out of stock) this is the correct entry point; for full record replacement call meta_ads.products.add with the same retailer_id (the add is upsert-semantic).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account_id | No | Meta Ads account ID in the format 'act_XXXXXXXXXX' (e.g. 'act_1234567890'). Optional — falls back to META_ADS_ACCOUNT_ID from the configured credentials. The leading 'act_' prefix is required. | |
| product_id | Yes | Meta-assigned product_id to update. | |
| name | No | New product display name. | |
| description | No | New product description. | |
| availability | No | New inventory status. Meta suppresses 'out of stock' / 'discontinued' from DPA delivery. | |
| price | No | New price as 'amount ISO_CURRENCY' (e.g. '1200 JPY'). | |
| url | No | New landing page URL (HTTPS). | |
| image_url | No | New primary image URL (HTTPS, publicly fetchable). | |
| brand | No | New brand name. | |
| category | No | New category path in Google Product Taxonomy format. |