Add a product to Meta Commerce Manager catalog using the Catalog Batch API with CREATE and UPDATE operations

Verified steps

1. Create a system user access token in Meta Business Manager with the catalog_management permission; the token must have access to the specific catalog (product catalog) you are managing.
2. POST to /{catalog_id}/items_batch (Graph API v21.0 or later) with allow_upsert: true and a 'requests' array; each request object has a 'method' of 'CREATE' or 'UPDATE', a 'retailer_id' as the unique product ID, and a 'data' object with required fields: name, description, availability, condition, price, currency, image_url, and url.
3. For variant products, include the item_group_id field in each variant's data object to group them under a parent; all variants sharing the same item_group_id are displayed as a single catalog item with selectable options.
4. Check the API response for 'handles' — submit GET /{catalog_id}/items_batch?handle={handle} to retrieve the batch processing result, which lists accepted items and any validation errors.
5. Use the Feed API (POST /{catalog_id}/product_feeds and a scheduled URL fetch) for feeds that update less frequently than once per hour; use the Batch API for near-real-time individual item updates.
6. Verify products are approved and not rejected by calling GET /{catalog_id}/products?fields=id,name,review_status,errors to surface policy violations before running ads.