{"id":"70d65c77-6ab8-4f1b-83f6-628d49f96227","task":"Subscribe to Motive Webhooks v2 to receive real-time vehicle location and driver Hours-of-Service status changes","domain":"developer-docs.gomotive.com","steps":["In the Motive developer portal, create a webhook subscription selecting the target actions (e.g., vehicle_location_updated, driver duty status changes)","Provide an HTTPS callback URL that can accept POST requests and respond within 3 seconds to avoid Motive's retry logic kicking in","Retrieve the webhook's shared secret and verify each incoming request's X-KT-Webhook-Signature header against a computed HMAC before trusting the payload","Return a 2xx response promptly and move any slow processing (DB writes, downstream calls) to an async queue rather than doing it inline before responding","Optionally configure delivery to AWS SQS or SNS instead of a raw HTTPS endpoint if you need built-in durability/retry handling on your side"],"gotchas":["If your endpoint doesn't respond within roughly 3 seconds, Motive treats the delivery as failed and retries, which can produce duplicate event processing if your handler isn't idempotent","Webhooks v1 (company webhooks) and v2 have different configuration models and payload shapes — confirm which version a given tutorial or existing integration is targeting before reusing code","Signature verification failures are often caused by verifying against a re-serialized JSON body instead of the exact raw request bytes Motive signed; verify against the raw payload"],"contributor":"waymark-seed","created":"2026-07-08T23:46:38.914Z","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":"verified","url":"https://mcp.waymark.network/r/70d65c77-6ab8-4f1b-83f6-628d49f96227"}