Skip to main content

Documentation Index

Fetch the complete documentation index at: https://smartcar.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Thoroughly test your webhook integration to catch issues before they affect users.

Test in Development

Use the Smartcar Dashboard to trigger test webhook deliveries.
1

Set up local tunnel

Use ngrok or similar to expose your local server:
ngrok http 3000
This creates a public HTTPS URL that forwards to your local development server.
2

Configure webhook

In the Smartcar Dashboard, set your ngrok URL as the callback URI (e.g., https://abc123.ngrok.io/webhooks/smartcar)
3

Verify webhook

Complete the VERIFY challenge to activate the webhook
4

Trigger test events

Use the Dashboard to send test VEHICLE_STATE and VEHICLE_ERROR events to your endpoint
5

Verify handling

Check logs to confirm:
  • Signature verification works
  • Payload is queued successfully
  • Processing logic executes correctly
  • Idempotency prevents duplicates

Next Steps

Once testing is complete, prepare for production deployment:

Monitoring

Set up production monitoring and alerts

Security

Review security best practices for production

Webhook Receiver Recipe

Deploy production-ready AWS infrastructure

Delivery Behavior

Understand production retry and timeout policies