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

FieldTypeRequiredDescription
emailstringYesThe 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.
namestringYesThe 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." } }