> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargeapi.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Driver

Creates a driver. Drivers store identity, licensing, and notification settings for vehicle and charging-session activity.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.chargeapi.co/v1/drivers \
    -H "Authorization: Bearer ch_sk_test_..." \
    --json '{
    "email": "example@example.com",
    "name": "Example Driver"
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
      "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
  }
  ```
</ResponseExample>

## Parameters

<ParamField body="email" type="string" required>
  Contact email address.
</ParamField>

<ParamField body="name" type="string" required>
  Full name of the driver.
</ParamField>

<ParamField body="phone" type="string">
  Optional phone number.
</ParamField>

## More parameters

<ParamField body="license_number" type="string">
  Driver's license or certification number.
</ParamField>

<ParamField body="metadata" type="object">
  Set of key-value pairs that you can attach to an object.
</ParamField>

<ParamField body="preferences" type="object">
  Driver preferences for charging behavior and routing.

  <Expandable title="properties">
    <ParamField body="charging_speed" type="string">
      Preferred charging speed.
    </ParamField>

    <ParamField body="currency" type="string">
      Preferred currency for cost display and billing.
    </ParamField>

    <ParamField body="default_payment_method" type="string | null">
      Default payment method ID assigned to the driver.
    </ParamField>

    <ParamField body="max_price_per_kwh" type="integer | null">
      Optional upper limit on acceptable charging price, in the smallest currency unit per kWh.
    </ParamField>

    <ParamField body="notifications" type="boolean">
      Whether to receive notifications about charging status and session progress.
    </ParamField>

    <ParamField body="preferred_charging_stations" type="array of string">
      List of preferred charging station IDs.
    </ParamField>

    <ParamField body="preferred_cpos" type="array of string">
      List of preferred charging network (CPO) IDs.
    </ParamField>
  </Expandable>
</ParamField>

## Returns

Returns the created driver.