POST
/
drivers
curl --request POST \
  --url https://api.chargeapi.co/v1/drivers
{
  "id": null,
  "object": null,
  "created": null,
  "email": null,
  "license_number": null,
  "name": null,
  "phone": null,
  "preferences": {
    "charging_speed": null,
    "charging_notifications": null,
    "currency": null,
    "payment_method": null,
    "max_price_per_kwh": null,
    "preferred_cpos": null,
    "preferred_stations": null
  },
  "status": null,
  "updated": null,
  "vehicles": null,
  "wallet_balance": null
}

Response

200 - application/json
A newly created driver.

A Driver represents an individual authorized to initiate and manage charging sessions. Drivers are typically associated with a fleet or account and are assigned to one or more vehicles.

​
id
string

Unique identifier for the driver object.

Example:

null

​
object
string

String representing the object’s type. Always driver.

Example:

null

​
created
integer

Time at which the driver was created (UNIX timestamp).

Example:

null

​
email
string

Email address used for login and notifications.

Example:

null

​
license_number
string | null

Driver’s license number, if applicable.

Example:

null

​
name
string

Full name of the driver.

Example:

null

​
phone
string | null

Optional phone number for communication and account recovery.

Example:

null

​
preferences
object

Driver’s personal preferences for charging experience and routing.

​
status
enum<string>

Current status of the driver account.

Available options:
active,
suspended,
archived
Example:

null

​
updated
integer

Time at which the driver object was last updated.

Example:

null

​
vehicles
string[]

List of vehicle IDs currently linked to the driver.

Example:

null

​
wallet_balance
integer

Driver’s wallet or prepaid balance in the smallest currency unit (e.g., cents).

Example:

null