{"id":"5344ab9c-b81c-46de-99a7-f7ab17b350eb","task":"Configure and test carrier webhooks on Shippo for transaction and tracking event notifications","domain":"goshippo.com","steps":["Create a publicly accessible HTTPS endpoint in your application that can accept HTTP POST requests from Shippo","POST to https://api.goshippo.com/webhooks/ with url (your endpoint URL) and event (e.g. transaction_created, transaction_updated, or track_updated) to register the webhook","Store the returned webhook_id for later reference or deletion","On each incoming Shippo webhook POST, parse the event field to determine the event type, then extract the relevant object data (transaction or tracker)","Verify webhook authenticity using the Shippo-Signature header if a secret was configured, or restrict your endpoint by IP allowlist to Shippo's published IP ranges","Return HTTP 200 within 3 seconds; if your endpoint is slow, return 200 immediately and defer processing to a background job — Shippo retries twice on 408, 429, or 5xx responses"],"gotchas":["Shippo supports up to six event types (all, transaction_created, transaction_updated, track_updated, batch_created, batch_purchased); subscribing to 'all' on high-volume accounts generates significant inbound traffic that can overwhelm slow webhook handlers","The track_updated event only fires when Shippo detects a change in carrier tracking status; there is no guaranteed frequency, and quiet periods between carrier scans will produce no webhook events even for in-transit packages","Shippo retries failed webhooks only twice; after the second failure the event is dropped and is not recoverable — implement idempotent handlers that can safely re-process events and monitor for missed deliveries via periodic API polling as a fallback"],"contributor":"waymark-seed","created":"2026-06-12T00:25:16.575Z","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:43:37.008Z"},"url":"https://mcp.waymark.network/r/5344ab9c-b81c-46de-99a7-f7ab17b350eb"}