Skip to main content
curl -X POST https://api.chargeapi.co/v1/drivers \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "email": "example@example.com",
  "name": "Example Driver"
}'

{
    "id": "drv_AhymM2g1ZLXkzuE0mmB4cpAKMyHfMvys",
    "object": "driver",
    "created": "2026-04-01T00:34:24.471Z",
    "email": "example@example.com",
    "fleets": [],
    "license_number": null,
    "metadata": {},
    "name": "Example Driver",
    "phone": null,
    "policy_ids": [],
    "preferences": {
        "charging_speed": "fast",
        "currency": "eur",
        "default_payment_method": null,
        "max_price_per_kwh": null,
        "notifications": true,
        "preferred_charging_stations": ["chst_myKhsjlZbts1baxuaNNF6OKR73vUdTev"],
        "preferred_cpos": ["example_operator"]
    },
    "status": "active",
    "updated": "2026-04-01T01:34:37.293Z",
    "vehicles": [],
    "wallet_balance": 0
}
Creates a driver. Drivers store identity, licensing, and notification settings for vehicle and charging-session activity. 
curl -X POST https://api.chargeapi.co/v1/drivers \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "email": "example@example.com",
  "name": "Example Driver"
}'

{
    "id": "drv_AhymM2g1ZLXkzuE0mmB4cpAKMyHfMvys",
    "object": "driver",
    "created": "2026-04-01T00:34:24.471Z",
    "email": "example@example.com",
    "fleets": [],
    "license_number": null,
    "metadata": {},
    "name": "Example Driver",
    "phone": null,
    "policy_ids": [],
    "preferences": {
        "charging_speed": "fast",
        "currency": "eur",
        "default_payment_method": null,
        "max_price_per_kwh": null,
        "notifications": true,
        "preferred_charging_stations": ["chst_myKhsjlZbts1baxuaNNF6OKR73vUdTev"],
        "preferred_cpos": ["example_operator"]
    },
    "status": "active",
    "updated": "2026-04-01T01:34:37.293Z",
    "vehicles": [],
    "wallet_balance": 0
}

​
Parameters

​
email
string
required
Contact email address.
​
name
string
required
Full name of the driver.
​
phone
string
Optional phone number.

​
More parameters

​
license_number
string
Driver’s license or certification number.
​
metadata
object
Set of key-value pairs that you can attach to an object.
​
preferences
object
Driver preferences for charging behavior and routing.

​
Returns

Returns the created driver.