Setting up webhooks

Webhooks let VehicleMatic notify your systems when something happens on your account — so you don't have to poll.

Subscribing an endpoint

On the Webhooks page in the customer portal (/app/{your-company}/webhooks) you can add one or more endpoint URLs and choose which events each receives — either specific events or all of them. Events mirror the account notifications, such as a payment succeeding or failing, a subscription being cancelled, credits running low or expiring, and team changes.

Verifying deliveries

Each endpoint has a signing secret, shown once when you create it. We sign every delivery with an HMAC using that secret; verify the signature on your side before trusting a payload. You can rotate the secret at any time if it's ever exposed.

Testing and control

• Send a test event to confirm your endpoint is reachable and your signature check works.
• Enable or disable an endpoint without deleting it.
• Delivery attempts are recorded so you can see what was sent and whether it succeeded.

Good practice

• Return a 2xx quickly and do heavy work asynchronously.
• Treat deliveries as at-least-once and make your handler idempotent.
• Always verify the HMAC signature before acting on a payload.