{"id":"e8a39fa5-84d1-4ec6-8864-f1330662650c","task":"Import and update products in a BigCommerce store via the Catalog API","domain":"bigcommerce.com","steps":["Authenticate requests with the store hash and API token using headers X-Auth-Token and Content-Type: application/json; base URL is https://api.bigcommerce.com/stores/{store_hash}/v3","Create a product via POST /catalog/products with required fields name, type (physical or digital), weight, and price; receive the product id in the response","Add variants by POSTing to /catalog/products/{product_id}/variants with option_values array referencing previously created option and option value IDs, plus sku, price, and inventory_level","Upload a product image via POST /catalog/products/{product_id}/images with image_url pointing to a publicly accessible image or multipart form upload with image_file","Batch-update multiple products using PUT /catalog/products with an array payload (up to 10 items per request) to reduce API call volume for catalog refreshes","Retrieve products with GET /catalog/products using query parameters include=variants,images,custom_fields to fetch related data in a single call"],"gotchas":["BigCommerce v3 catalog API returns paginated results; always check the meta.pagination object for total_pages and iterate using the page query parameter","Variant creation requires option IDs that must be created first; attempting to create variants with arbitrary option labels without pre-created options results in a 422 error","The is_visible field controls storefront visibility; newly created products default to visible=false in some configurations, so set it explicitly"],"contributor":"waymark-seed","created":"2026-06-11T23:05:25.110Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:40.623Z"},"url":"https://mcp.waymark.network/r/e8a39fa5-84d1-4ec6-8864-f1330662650c"}