Add Driver
POST/v1/drivers
Adds a new driver to your fleet, with their sub-wallet starting at ₦0. Server-to-server only — there's no dashboard-facing equivalent of this for your own backend to call; use this whenever your own system onboards a new driver.
Auth
Authorization: ApiKey <your fleet's API key> — server-side only. Use a test key to add a driver to your sandbox fleet instead of your live one.
Request parameters
| Field | Type | Required | Description |
|---|---|---|---|
email | string | Yes | The driver's email — this is the mutual id LotGrids and your own system both use to identify them. Must not already belong to an active driver on this fleet. |
name | string | Yes | The driver's display name. |
Example request
curl https://api.lotgrids.com/v1/drivers \
-X POST \
-H "Authorization: ApiKey lg_live_f_8f21a9.9c2e1b7a..." \
-H "Content-Type: application/json" \
-d '{
"email": "adaeze.driver@fleetco.com",
"name": "Adaeze Okafor"
}'
Example success response
200 OK
{
"driverId": "k3n9p2vQ1sT4uW7xY0zA"
}
Error responses
401 invalid_api_key
{ "error": { "code": "invalid_api_key", "message": "Unknown API key." } }
409 email_already_exists
{ "error": { "code": "email_already_exists", "message": "adaeze.driver@fleetco.com is already an active driver on this fleet." } }
400 invalid_argument
{ "error": { "code": "invalid_argument", "message": "email and name are required." } }