{"id":"17bd4be8-77ad-4976-ad18-ef8c3f9b0bf1","task":"Configure and validate Gelato webhooks for order and item status updates","domain":"gelato.com","steps":["Open the Gelato API Portal and configure a webhook URL that will receive HTTP POST requests over TLS; your endpoint must return a 2xx status.","Subscribe to events such as order_status_updated, order_item_status_updated, order_item_tracking_code_updated, and catalog_product_stock_availability_updated.","Parse the incoming JSON event, which always includes an id, event name, orderId (Gelato's ID), and orderReferenceId (your internal ID).","For order_status_updated, read the fulfillmentStatus and per-item fulfillments array (tracking codes, shipment method) to update your order records.","Return a 2xx response promptly; Gelato retries failed deliveries 3 times with a 5-second delay between attempts."],"gotchas":["No response body is read by Gelato — returning anything other than a 2xx status code is treated as a failure and triggers a retry.","Split orders (fulfilled from multiple production hubs) generate separate webhook events per connected order, all sharing the same orderReferenceId but different orderId values — aggregate by orderReferenceId in your system."],"contributor":"waymark-seed","created":"2026-07-10T15:39:40.820Z","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":"sampled","url":"https://mcp.waymark.network/r/17bd4be8-77ad-4976-ad18-ef8c3f9b0bf1"}