Skip to main content
Once you’ve created a webhook, you need to subscribe vehicles to it before they’ll start receiving data. Smartcar offers three methods to manage vehicle subscriptions: automatic enrollment, Dashboard management, and programmatic API control.
Data will only be sent after your webhook has been verified. See Callback Verification for details.

​
Subscription Methods

Auto-Enrollment

Automatic subscription for all connected vehicles

Dashboard

Manual subscription through the Smartcar Dashboard

API

Programmatic subscription via REST API
The simplest way to manage subscriptions is to enable auto-enrollment when creating your webhook. This automatically subscribes all vehicles connected to your application.
All vehicles will be subscribed immediately. When you enable auto-enrollment, all currently connected vehicles will be subscribed to the webhook right away. Only enable this feature when you’re ready to receive data for all vehicles in your application.

​
How It Works

When auto-enrollment is enabled:
  • Existing vehicles are immediately subscribed to the webhook
  • New connections are automatically subscribed when users connect vehicles
  • No manual management required for individual vehicles

​
Enable Auto-Enrollment

1

Navigate to Dashboard

Go to the Smartcar Dashboard and create or edit a webhook
2

Enable Auto-Subscribe

Check the “Automatically subscribe all vehicles” option during webhook creation
Auto-subscribe toggle in Dashboard
3

Save Configuration

Complete webhook creation - all vehicles will be subscribed automatically
Best for: Production deployments where all connected vehicles should receive webhook data

​
Method 2: Dashboard Management

For selective subscription, you can manually subscribe individual vehicles through the Dashboard.

​
Subscribe via Dashboard

1

Access Vehicle List

Navigate to Vehicles in the Dashboard
2

Select Vehicle

Click on the vehicle you want to subscribe
3

Manage Subscriptions

In the vehicle details, find the “Webhook Subscriptions” section
Webhook Subscription in Smartcar Dashboard

Webhook Subscription in Smartcar Dashboard

4

Add or Remove

Click “Subscribe” to add the vehicle to a webhook, or “Unsubscribe” to remove it
Best for: Testing and development, selective vehicle management, or gradual rollouts

​
Method 3: API Subscription

For programmatic control, use the subscribe and unsubscribe API endpoints.
Best for: Testing and development, dynamic subscription management, custom business logic, or bulk operations Best for: Dynamic subscription management, custom business logic, or bulk operations

​
Common Questions

Yes! You can enable auto-enrollment for most vehicles and use the API or Dashboard for exceptions. However, be aware that auto-enrollment will automatically subscribe new vehicles.
The vehicle immediately stops receiving webhook deliveries. You can re-subscribe at any time, and a new first payload will be sent.
You can view all vehicle subscriptions in the Dashboard or use the Management API to programmatically list subscriptions.
No, you can subscribe as many vehicles as are connected to your application. Webhooks scale automatically to handle your fleet size.
Not necessarily. You can use one webhook for all vehicles and handle signal availability differences using the VEHICLE_ERROR events for unsupported signals.

​
Next Steps

Receiving Webhooks

Requirements for building your webhook endpoint

Event Reference

Understand all types of available payloads

Delivery Behavior

Learn about retry policies and guarantees

Callback URI Verification

Ensure your endpoint passes Smartcar’s verification challenge