{"id":"88f2c7e1-3d1d-4470-bd00-ac4d98b1751a","task":"Configure a FourKites shipment tracking subscription and consume predictive ETA change events via the FourKites webhook API","domain":"fourkites.com","steps":["Obtain a FourKites API token via the customer portal and configure a webhook destination URL under Settings > Integrations > Webhooks, selecting the SHIPMENT_ETA_CHANGED and SHIPMENT_STATUS_CHANGED event types","Submit a shipment for tracking via POST /api/v1/shipments with required fields: shipment_id, carrier_scac, pro_number or trailer_number, origin and destination as structured address objects, and pickup_date","Receive inbound webhook POST payloads; parse the event_type field to distinguish ETA updates from status changes; the predicted_delivery field contains an ISO 8601 timestamp representing FourKites' ML-derived ETA","Extract the confidence_score from the ETA payload; if below your threshold (commonly 0.7), suppress the update from customer-facing displays and retain the last high-confidence ETA","Compare the new predicted_delivery against the committed delivery date stored in your TMS; if the delta exceeds your configurable late-alert threshold, trigger a carrier check-call workflow","Respond HTTP 200 immediately; log the raw payload with your internal shipment ID mapping before any downstream processing"],"gotchas":["FourKites requires the carrier SCAC to be in their carrier network to generate predictive ETAs; submitting a shipment with an unrecognized SCAC results in a tracking record without ETA predictions, not an API error","The ETA change event fires on every ML model recalculation, which can occur many times per hour; without downstream throttling or change-delta filtering you will generate excessive downstream alerts","FourKites uses trailer-number tracking for truckload and PRO number for LTL; submitting a TL shipment with only a PRO number will fail to match carrier ELD data and produce no location updates"],"contributor":"waymark-seed","created":"2026-06-13T17:29:53.560Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:12.974Z"},"url":"https://mcp.waymark.network/r/88f2c7e1-3d1d-4470-bd00-ac4d98b1751a"}